List Undeliverable TED IN Credits

Use this endpoint to list the inbound TED credits that could not be delivered, so an operator can tell a recipient that does not exist from a ledger refusal, and see how far the re-querying of each one has got, without database access. The rejection reason is a fixed sentence derived from the category; no customer identity or upstream error text is exposed.

This is a read-only administrative endpoint. It does not require the X-Organization-Id header. In multi-tenant deployments the list is scoped to the caller’s resolved tenant database.

GET /v1/transfers/ted-in/undeliverables

List Undeliverable TED IN Credits

cURL

curl --request GET \
  --url https://api.example.com/v1/transfers/ted-in/undeliverables \
  --header 'Authorization: Bearer <token>'

200

{
  "items": [
    {
      "id": "018f3a1c-1b2c-7def-8a9b-0c1d2e3f4a5b",
      "jdIncomingMessageId": "018f3a1c-1b2c-7def-8a9b-0c1d2e3f4a5c",
      "messageSequence": "SEQ-42",
      "controlNumber": "202602010001",
      "amount": "15000.00",
      "rejectionCategory": "RECIPIENT_NOT_FOUND",
      "rejectionReason": "no recipient account was found in any organization bound to this tenant",
      "resolutionStatus": "PENDING",
      "returnControlNumber": "20260201000000000001",
      "reconciliationAttempts": 3,
      "lastVendorCode": "ALC02",
      "createdAt": "2026-02-01T15:30:00Z",
      "updatedAt": "2026-02-01T15:35:00Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "returned": 2,
    "totalCount": 123,
    "hasNextPage": false
  }
}

Autorizaciones

BearerAuthOAuth2ClientCredentialsOAuth2Password

Authorization · string · header · requerido

JWT Bearer token authentication. The tenantId is derived from the bearer token or authenticated request context and is not supplied through X-Organization-Id.

Scopes

api · OAuth2ClientCredentials

TED transfer API access

api · OAuth2Password

TED transfer API access

Parámetros de consulta

status · enum<string>

Filter by resolution status.

Opciones disponibles: PENDING, IN_PROGRESS, RETAINED, RETURNED, ABSORBED, FAILED

category · enum<string>

Filter by rejection category.

Opciones disponibles: RECIPIENT_NOT_FOUND, RECIPIENT_ACCOUNT_INVALID, MALFORMED_MESSAGE, FEE_RESOLUTION_FAILED, MIDAZ_REJECTION, CREDITED_AMOUNT_ZERO, ORGANIZATION_MISSING, ISPB_NOT_OWNED_BY_TENANT

limit · integer · predeterminado: 50

Maximum number of records to return.

Rango requerido: 1 <= x <= 200

offset · integer · predeterminado: 0

Number of records to skip for pagination. Advance it by the returned value of the previous page.

Rango requerido: x >= 0

Respuesta

200

application/json

Indicates that the request was successful and the matching undeliverable credits are returned.

items · object[]

Show child attributes

pagination · object

Show child attributes