How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Nacha Reporting ACH Return Payments API

The Reporting ACH Return Payments API from Nacha — 1 operation(s) for reporting ach return payments.

Nacha Reporting ACH Return Payments API is one of 19 APIs that Nacha publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Reporting ACH Return Payments. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

This API exposes 1 operation across 1 path, and defines 11 schemas. It is described by OpenAPI 3.2.0, at version 1.0.3.

Requests are made against a single base URL, https://api.afinis.org/payments/ach/v1.

1 operations 1 paths 11 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.3
Base URL
https://api.asig.org/v1
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Nacha Reporting ACH Return Payments API declares 1 security scheme for authenticating requests. An API key is passed in the query as apikey (APIKeyQueryParam).

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

Reporting ACH Return Payments 1
POST
/ret
Alert the network of ACH users about problematic ACH payments to help mitigate the risk of suspected bad actors perpetuating fraud against other ACH users
Reporting ACH Return Payments body → 200400401403404500503

Schemas 11

The contract defines 11 schemas that model the data the API accepts and returns. The most detailed are error-503 (2 properties), errorDetails-400 (2 properties), errorDetails-401 (2 properties), account (2 properties). Each schema is shown below with its type and property counts.

error-500
object
1 property
errorDetails-401
object
2 properties 2 required
errorDetails-400
object
2 properties
error-401
object
Authentication failed or user doesn’t have permissions for requested operation
1 property
response-200
object
1 property 1 required
error-503
object
Service is temporarily unavailable
2 properties 2 required
errorDetails-500
object
2 properties 2 required
error-400
object
The request could not be understood or required parameters were missing
1 property
agent
object
Identification of a financial institution.
2 properties
error-404
object
Resource was not found.
2 properties 2 required
account
object
Details to identify an account
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

nacha-reporting-ach-return-payments-api-openapi.yml Raw ↑

Other APIs Nacha publishes across the network.

Nacha Account Validation API
Nacha Accounts API
Nacha ACH Payments API
Nacha ACH Transaction Status API
Nacha Authorize to Pay API
Nacha Banks API
Nacha Expand Bank Contact V2 API
Nacha Get Corporate Account Balances API
Nacha Get Corporate Transaction History API
Nacha Get Participants Profile API
Nacha Initiate Payment API
Nacha Instant Payment API
Where this information came from

This is an independent, third-party profile of Nacha Reporting ACH Return Payments API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.