Get transaction timeline

Returns the timeline of events for a single transaction (by PIX end-to-end ID or integrator identifier). Includes creation, BACEN confirmations (inbound webhooks as short descriptions), outbound webhooks sent to the client (with optional full payload for "Ver payload completo"), fees, refunds, and QR code lifecycle when applicable. Exactly one of `endToEndId` or `identifier` is required.

Authentication

AuthorizationBearer

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

Path parameters

accountIdstringRequired
Account 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.

Query parameters

endToEndIdstringOptional

PIX end-to-end ID. Mutually exclusive with identifier.

identifierstringOptional

Integrator reference (payment/QR identifier). Mutually exclusive with endToEndId.

Response

Transaction timeline.
transactionobject
Short summary of the transaction for the timeline response.
timelinelist of objects

Errors

400
Bad Request Error
404
Not Found Error
500
Internal Server Error