API Internet BankingTed

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.
X-Request-TimestampstringRequired

Unix seconds. Required on the signed host; tolerance is 300s either way (403 request_timestamp_skew).

X-Content-SHA256stringRequired

Lowercase hex SHA-256 of the body. An empty body hashes the empty string, so the header is always present. Mismatch returns 400 body_hash_mismatch.

X-Request-SignaturestringRequired

Detached JWS (<protected>..<signature>, ES256 or PS256) over METHOD\nPATH?QUERY\nTIMESTAMP\nIDEMPOTENCY_KEY_OR_EMPTY\nX_CONTENT_SHA256.

Response

Current TED state.
tedIdstring
accountIdstring
statusenum
amountdoubleOptional
identifierstringOptional
descriptionstringOptional
partnerIdstringOptional

Settlement bank’s reference (= identifier in current MT implementation).

createdAtdatetimeOptional
updatedAtdatetimeOptional

Errors

403
Forbidden Error
404
Not Found Error
500
Internal Server Error