Retrieve transaction

Returns a transaction by its unique identifier, including details about the transaction's state and relevant transactional data.

Add expand to embed related resources under _embedded in the same response, for example
expand=cardSubscription,card,cardholder. Each embedded resource is the exact body its own endpoint
serves, shows its current values (not those at the time of the transaction), and requires that
endpoint's scope: card-subscriptions:read for cardSubscription, cards:read for card,
cardholder:read for cardholder.

For the company and legal entity a card belongs to, use expand=cardholder and read
cardholder.corporate.id and cardholder.corporate.legalEntity. They are the cardholder as it
is now. Transactions themselves do not carry a company identifier.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required
Query Params
expand
array of strings

Comma-separated list of related resources to embed on the transaction under _embedded, so one call
returns the transaction together with its card subscription, card and cardholder instead of follow-up
calls to GET /card-subscriptions?cardId=, GET /cards/{cardId} and GET /cards/{cardId}/cardholder.

  • cardSubscription embeds the card subscription exactly as GET /card-subscriptions/{subscriptionId}
    serves it (without its own _embedded) and requires the card-subscriptions:read scope.
  • card embeds the transaction's card exactly as GET /cards/{cardId} serves it (without its own
    _embedded) and requires the cards:read scope.
  • cardholder embeds the card's cardholder exactly as GET /cards/{cardId}/cardholder serves it and
    requires the cardholder:read scope.

Each value is checked separately: a request asking to expand a resource its credentials cannot read is
refused with 403.

The embedded subscription is the card's subscription in the transaction's sub-account: the one from
the transaction's network bulk feed when the transaction has a networkBulkFeedId, otherwise the
card's current subscription, otherwise its most recent one.

Embedded resources show their current values, not the values they had when the transaction
happened.

A key is present only when it was requested and the related resource exists, and it is never null.
A transaction with no card (cardId is null, for example a bank-sourced transaction with no linked
card) has no cardSubscription, card or cardholder. A card without cardholder data has no
cardholder. A card that GET /cards/{cardId} no longer returns (it responds 404, for example
because all of its card subscriptions were deleted) is not embedded: both card and cardholder are
absent. _links are unchanged. Without expand, _embedded is absent.

Send one comma-separated value (expand=cardSubscription,card,cardholder). A repeated expand key,
an empty value or an unknown value is refused with 400.

expand
Allowed:
Headers
string
enum
Defaults to application/hal+json

Generated from available response content types

Allowed:
Responses

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/hal+json
application/problem+json