API documentation | API docs for agents | OpenAPI 3.1

GET /api/v1/billing/carrier-ach-files/{nachaFileId}

ark.get_carrier_ach_file

Returns a visible carrier ACH/NACHA batch with entries and linked carrier payments for reconciliation.

Availability
Expanded preview
Scopes
loads:readbilling:read
ARK permissions
canViewLoadscanViewBilling
Team visibility
Required and enforced
Idempotency-Key
Not required
Approval
No MCP approval on REST API-token calls
Rate limit
API credential and organization budgets

Parameters

nachaFileIdpathstringrequired
format: uuid

Request body

None.

Example request

Shell
curl 'https://arktms.com/api/v1/billing/carrier-ach-files/<nachaFileId>' \
  -H "Authorization: Bearer $ARK_API_TOKEN"

Success response

Carrier ACH file

objectstringrequired
okbooleanrequired
api_versionstringrequired
request_idstringrequired
dataobjectrequired
data.nachaFileIdstringrequired

format: uuid

data.batchNumberintegerrequired
data.fileNamestringrequired
data.effectiveDatestringrequired

format: date

data.totalAmountstringrequired

Decimal total amount as a string.

data.entryCountintegerrequired
data.statusstringrequired
data.createdAtstringrequired

format: date-time

data.createdByNamestringrequired
data.csvDataarray<any> | object | nullrequired

Stored reconciliation CSV metadata for the batch.

Errors

HTTP 400
Invalid request
HTTP 401
Authentication required
HTTP 403
Permission, scope, team, or entitlement denied
HTTP 404
Resource not found