Get the timeline of one transaction by id

curl https://client.api.corpx.com/v1/transactions/transactionId/timeline \
     -H "X-Content-SHA256: X-Content-SHA256" \
     -H "X-Request-Signature: X-Request-Signature" \
     -H "X-Request-Timestamp: X-Request-Timestamp" \
     -H "X-Tenant-Id: X-Tenant-Id" \
     -H "Authorization: Bearer <token>"

{
  "transactionId": "8c1f6a2e-4d3b-4b9a-9f0e-1a2b3c4d5e6f",
  "level": "public",
  "events": [
    {
      "eventId": "8c1f6a2e-4d3b-4b9a-9f0e-1a2b3c4d5e6f",
      "transactionId": "8c1f6a2e-4d3b-4b9a-9f0e-1a2b3c4d5e6f",
      "type": "pix_out.confirmed",
      "occurredAt": "2026-02-20T08:33:39Z",
      "workflowId": "8c1f6a2e-4d3b-4b9a-9f0e-1a2b3c4d5e6f",
      "runId": "8c1f6a2e-4d3b-4b9a-9f0e-1a2b3c4d5e6f",
      "source": "MANUAL",
      "audience": "public",
      "severity": "info",
      "actor": "maria.silva@example.com",
      "message": "Pagamento pedido #12345",
      "recordedAt": "2026-02-20T08:33:39Z",
      "payload": {}
    }
  ]
}

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 reserved for the internal backoffice route and is ignored here.

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 reserved for the internal backoffice route 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-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.

Response

Timeline found.

transactionIdstring

Canonical transaction id, resolved from whichever alias was sent in the path.

levelenum

Always public on this route; level=full is reserved for the internal backoffice path.

eventslist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error