{"id":46868,"library":"ach-node-sdk","title":"ACH Node SDK","description":"The ACH Node SDK is a generated TypeScript client for the moov-io/ach REST API, providing typed access to ACH file operations. Current stable version is 1.12.0, released on a monthly cadence. It differs from other ACH libraries by being auto-generated from the OpenAPI spec, ensuring API parity, and shipping with full TypeScript definitions for type safety. Designed for Node.js and TypeScript projects, it simplifies integration with moov-io/ach services for creating, parsing, and managing ACH files.","status":"active","version":"1.12.0","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","openapi","rest","node","sdk","typescript"],"install":[{"cmd":"npm install ach-node-sdk","lang":"bash","label":"npm"},{"cmd":"yarn add ach-node-sdk","lang":"bash","label":"yarn"},{"cmd":"pnpm add ach-node-sdk","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"HTTP client for API requests","package":"axios","optional":false}],"imports":[{"note":"CommonJS require works but ESM import is preferred for TypeScript support.","wrong":"const ACHFilesApi = require('ach-node-sdk').ACHFilesApi","symbol":"ACHFilesApi","correct":"import { ACHFilesApi } from 'ach-node-sdk'"},{"note":"Both import and require are supported. Ensure basePath option is provided.","wrong":"const { Configuration } = require('ach-node-sdk')","symbol":"Configuration","correct":"import { Configuration } from 'ach-node-sdk'"},{"note":"Type export used for creating ACH file objects.","wrong":null,"symbol":"AchFile","correct":"import { AchFile } from 'ach-node-sdk'"}],"quickstart":{"code":"import { ACHFilesApi, Configuration } from 'ach-node-sdk';\n\nconst configuration = new Configuration({ basePath: 'https://ach.mycompany.com' });\nconst api = new ACHFilesApi(configuration);\n\nasync function listFiles() {\n  try {\n    const response = await api.getFiles();\n    console.log('Files:', response.data);\n  } catch (error) {\n    console.error('Error fetching files:', error);\n  }\n}\n\nlistFiles();","lang":"typescript","description":"Demonstrates setting up the configuration and API client, then listing ACH files asynchronously."},"warnings":[{"fix":"Update package.json and imports to use 'ach-node-sdk'.","message":"Version 1.0.0 changed the package name from 'ach-sdk' to 'ach-node-sdk'. All imports must be updated.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Replace `BaseAPI` with the appropriate typed API class.","message":"The `BaseAPI` class is deprecated in favor of specific API classes like `ACHFilesApi`.","severity":"deprecated","affected_versions":">=1.5.0"},{"fix":"Ensure basePath is e.g., 'https://ach.mycompany.com' not 'ach.mycompany.com/'.","message":"The `basePath` property in Configuration must include the protocol (https://) and no trailing slash.","severity":"gotcha","affected_versions":">=0.1.0"}],"env_vars":null,"search_vec":"'/ach':18,78 '1.12.0':32 'access':23 'ach':1,5,25,42,85 'api':20,54 'auto':47 'auto-gener':46 'cadenc':37 'client':12 'creat':81 'current':28 'definit':61 'design':65 'differ':39 'ensur':53 'file':26,86 'full':59 'generat':10,48 'integr':73 'io':17,77 'javascript':87 'librari':43 'manag':84 'month':36 'moov':16,76 'moov-io':15,75 'node':2,6,90 'node.js':67 'openapi':51,88 'oper':27 'pariti':55 'pars':82 'project':70 'provid':21 'releas':33 'rest':19,89 'safeti':64 'sdk':3,7,91 'servic':79 'ship':57 'simplifi':72 'spec':52 'stabl':29 'type':22,63 'typescript':11,60,69,92 'version':30","created_at":"2026-06-07T16:47:58.332846+00:00","updated_at":"2026-06-07T16:47:58.332846+00:00","problems":[{"fix":"Instantiate Configuration with a valid basePath.","cause":"SDK not configured properly; missing or invalid basePath.","error":"TypeError: Cannot read properties of undefined (reading 'request')"},{"fix":"Run 'npm install ach-node-sdk' and verify import path.","cause":"Package not installed or import path incorrect.","error":"Module not found: Can't resolve 'ach-node-sdk'"},{"fix":"Check generated docs for correct method name (e.g., listFiles).","cause":"Using wrong version of the SDK; method may have been renamed.","error":"Property 'getFiles' does not exist on type 'ACHFilesApi'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":"ach-node-sdk","openapi_spec":null,"status_page":null,"smithery":null,"categories":["payments"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}