Get the timeline of one transaction by id

GET

https://tenant.api.corpx.com/v1/transactions/:transactionId/timeline

GET

/v1/transactions/:transactionId/timeline

curl https://tenant.api.corpx.com/v1/transactions/transactionId/timeline \
     -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.

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

Authentication

Path parameters

Headers

Response

Errors