Skip to navigation

Get TED status

Returns the current state of a TED previously created via POST /v1/accounts/{accountId}/ted/out.

States: PROCESSING → COMPLETED | FAILED. The server’s defensive polling guarantees convergence within 48 hours.

Since v2.22.0 this is the canonical path. The legacy path GET /v1/accounts/{accountId}/transfers/ted/{tedId} still works but is deprecated and will be removed in a future major.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

accountIdstringRequired
Account identifier.
tedIdstringRequired

TED identifier returned by the create endpoint (format ted-{identifier}).

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.

Response

Current TED state.
tedIdstring
accountIdstring
statusenum
Allowed values:
amountdoubleOptional
identifierstringOptional
descriptionstringOptional
partnerIdstringOptional

Settlement bank reference. Same value as identifier.

createdAtdatetimeOptional
updatedAtdatetimeOptional

Errors

403
Forbidden Error
404
Not Found Error
500
Internal Server Error