Skip to navigation

Get transaction status by E2E or identifier

Queries a PIX transaction by E2E (End-to-End ID) or identifier at the settlement bank, at the time of the call.

This route is an alias of GET /v1/accounts/{accountId}/statement: the response is always the statement list payload (items[]), never a single object.

  • With endToEndId or identifier it is an exact lookup: items holds 0 or 1 transaction, and pagination, dates and operation are ignored. When both are sent, identifier is tried first and endToEndId is used if it finds nothing.
  • A transaction that does not exist is not a 404: the response is 200 with items: [] and totalElements: 0.
  • Without either parameter the route returns the paginated statement, with the same parameters and rules as GET /statement.

Each item has the AccountStatementEntry shape. direction is IN (received) or OUT (sent), and amount is negative on OUT.

Important: Only completed or attempted PIX transfers appear here. QR Codes that were never paid are not transactions (they have no E2E ID). To query QR Code status regardless of payment, use GET /v1/accounts/{accountId}/pix/qr-code/lookup.

To get the payment as a single object (with hold, partnerStatus and waitForFinalStatus), use GET /v1/accounts/{accountId}/pix/payments/lookup.

Authentication

AuthorizationBearer

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

Path parameters

accountIdstringRequiredformat: "uuid"
Account ID.

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.

Query parameters

endToEndIdstringOptional

Transaction E2E ID (format E + ISPB + date + sequence). endToEnd is accepted as an alias.

identifierstringOptional

Charge identifier (txid) or internal reference.

Response

Statement list payload. On an exact lookup, items holds the transaction found, or is empty when there is none.

accountIdstring
itemslist of objects

Page of statement rows. Length may be less than size.

tenantIdstringOptional
sourcestringOptional
startDatedateOptional
endDatedateOptional
pageintegerOptional

Zero-based page index.

sizeintegerOptional

Requested page size (ceiling). items may be shorter.

totalElementsintegerOptional

Total lines in the settlement-bank statement window. Approximate when rows are omitted after pagination.

totalPagesintegerOptional
hasNextbooleanOptional
fetchedAtdatetimeOptional

Errors

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