List pending reconciliation transfers

Lists the transfers that still need a reconciliation action, oldest first.

The unfiltered list also carries, with failureCode TED_OUT_DEVOLUTION_PARKED and flaggedAt set to the time the return arrived, every TED OUT that a return (STR0010R2) reached before it completed and that REFUND can still refund. Once its status is COMPLETED, refund the payer with the REFUND action of Resolve Transfer Reconciliation. While it is PROCESSING, it completes first. The row leaves the list when a REFUND completed and announced its refund, when the TED OUT ends FAILED with its hold released, and when the STR0010 devolution of a refund that the ledger refused is on file. A TED OUT that awaits reconciliation or sits in manual review is listed under that reason until it completes.

GET /v1/transfers/reconciliation/pending

List pending reconciliation transfers

cURL

curl --request GET \
  --url https://api.example.com/v1/transfers/reconciliation/pending \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Organization-Id: <x-organization-id>'

200

Example

{ "items": [ { "transferId": "019c96a0-ab10-7cde-f1a2-0e1f2a3b4c5d", "type": "TED_OUT", "status": "PROCESSING", "controlNumber": "202602010001", "flaggedAt": "2026-02-01T15:35:00-03:00", "failureCode": "JD_UNAVAILABLE", "failureClass": "unknown_state", "counterpartySystem": "JD_SPB", "reconciliationStatus": "MANUAL_REVIEW", "reconciliationAttempts": 5, "lastReconciliationAttemptAt": "2026-02-01T15:40:00Z", "settlementRejectionCode": "ALN01" } ], "failureConcentration": [ { "failureCode": "JD_UNAVAILABLE", "count": 12 } ], "pagination": { "limit": 50, "returned": 25, "hasNextPage": true } }

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

Encabezados

X-Organization-Id · string<uuid> · requerido

Midaz organization scope for the request, used for downstream CRM, Fees, and Midaz calls. Required on org-scoped transfer routes in every deployment mode; a missing or non-UUID value returns 400. This is not the tenant identifier — tenantId is derived from the bearer JWT or authenticated context, never from this header. Background workers (TED IN poller, reconciliation) have no request header and, in single-tenant mode, fall back to the deployment's ORGANIZATION_ID env.

Parámetros de consulta

limit · integer · predeterminado: 50

Maximum number of records to return (1–200, default 50).

Rango requerido: 1 <= x <= 200

reconciliationStatus · enum<string>

Lists only the transfers in this reconciliation state. Omit it to list every transfer that still needs an action. Any value hides the TED_OUT_DEVOLUTION_PARKED rows.

• AWAITING: the worker still queries the settlement.
• MANUAL_REVIEW: a person must decide. This includes the transfers stored as EXHAUSTED.
• REVERSING: an inbound chargeback held on the ledger, retried every cycle.

Opciones disponibles: AWAITING, MANUAL_REVIEW, REVERSING

Respuesta

200

application/json

Pending reconciliation list returned successfully.

items · object[]

Transfers that still need a reconciliation action.

Show child attributes

failureConcentration · object[]

Breakdown of failure codes across pending items.

Show child attributes

pagination · object

Pagination metadata.

Show child attributes