Skip to navigation

Get the timeline of one transaction by id

Returns the curated event timeline of a transaction. Unlike /v1/accounts/{accountId}/transactions/timeline, which looks the transaction up by endToEndId/identifier, this route takes the id in the path and accepts several aliases: our internal paymentId, the partner id echoed on creation, the BACEN end-to-end id, or a QR txid.

Only the public event vocabulary is returned. level=full is not part of this contract and is ignored here.

Authentication

AuthorizationBearer

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

Path parameters

transactionIdstringRequired

Internal paymentId, partner id, endToEndId or QR txid.

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

Timeline found.
transactionIdstring
Canonical transaction id, resolved from whichever alias was sent in the path.
levelenum

Always public on this route. A fuller level is not part of this contract.

Allowed values:
eventslist of objects

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error