{
"id": "342ea759-8870-418a-aa4c-ebc3a93ff70d",
"source_payment_id": "ab8861be-020f-6449-655e-c7b00ff71b74",
"reference": "Sent from Incard",
"payee_id": "6992e50e-dfd7-4d9c-891c-362ccfc01b58",
"payee_route": "local",
"company_id": "bebb185d-8210-4e66-ac63-397b49a1e09f",
"account_id": "0d6c0a2a-2b08-49bc-89a9-eb936c9ff28c",
"name": "ACME Corp",
"status": "completed",
"type": "out",
"direction": "debit",
"authorized_at": "2026-07-02T16:07:39.942Z",
"completed_at": "2026-07-02T16:08:11.104Z",
"transaction_at": "2026-07-02T16:07:39.917Z",
"account_amount": {
"value": "-300.00",
"currency": "GBP"
},
"transaction_amount": {
"value": "-300.00",
"currency": "GBP"
},
"base_amount": {
"value": "-300.00",
"currency": "GBP"
},
"running_balance": {
"value": "4700.00",
"currency": "GBP"
},
"user_id": "29b297ca-c617-437e-9c1d-32f494fbf44d",
"user": {
"first_name": "Alex",
"last_name": "Example",
"icon_url": "https://cdn.incard.com/avatars/29b297ca.png"
},
"created_at": "2026-07-02T16:07:39.970773Z",
"updated_at": "2026-07-02T16:08:11.120114Z"
}{
"error": "id must be a UUID"
}{
"error": "not found"
}Get transaction
Returns a single transaction by UUID. Responds 404 when the transaction does not belong to the
company in X-On-Behalf-Of or sits in an account the API key’s member cannot access.
{
"id": "342ea759-8870-418a-aa4c-ebc3a93ff70d",
"source_payment_id": "ab8861be-020f-6449-655e-c7b00ff71b74",
"reference": "Sent from Incard",
"payee_id": "6992e50e-dfd7-4d9c-891c-362ccfc01b58",
"payee_route": "local",
"company_id": "bebb185d-8210-4e66-ac63-397b49a1e09f",
"account_id": "0d6c0a2a-2b08-49bc-89a9-eb936c9ff28c",
"name": "ACME Corp",
"status": "completed",
"type": "out",
"direction": "debit",
"authorized_at": "2026-07-02T16:07:39.942Z",
"completed_at": "2026-07-02T16:08:11.104Z",
"transaction_at": "2026-07-02T16:07:39.917Z",
"account_amount": {
"value": "-300.00",
"currency": "GBP"
},
"transaction_amount": {
"value": "-300.00",
"currency": "GBP"
},
"base_amount": {
"value": "-300.00",
"currency": "GBP"
},
"running_balance": {
"value": "4700.00",
"currency": "GBP"
},
"user_id": "29b297ca-c617-437e-9c1d-32f494fbf44d",
"user": {
"first_name": "Alex",
"last_name": "Example",
"icon_url": "https://cdn.incard.com/avatars/29b297ca.png"
},
"created_at": "2026-07-02T16:07:39.970773Z",
"updated_at": "2026-07-02T16:08:11.120114Z"
}{
"error": "id must be a UUID"
}{
"error": "not found"
}Authorizations
Short-lived access token. Obtain with your api_key.
Path Parameters
Transaction UUID.
Query Parameters
true includes a user object when the transaction has a user_id.
true includes a card object when the transaction has a card_token.
Response
The transaction.
A transaction on one of the company's accounts. Optional fields are omitted from the JSON when they have no value.
Amounts are signed: debit transactions carry negative values, credit transactions positive values.
Transaction UUID. Stable across status changes and matches the data.id in transaction webhooks.
Identifier of the payment in the originating source system.
Company UUID that owns the transaction.
UUID of the account the transaction belongs to.
Human-readable label (merchant, payee, or sender name).
Lifecycle status. pending transitions to completed, declined, or reversed; the other states are terminal.
pending, completed, declined, reversed Transaction type.
card, atm, refund, credit, out, in, fee, exchange_out, exchange_in, transfer_out, transfer_in, chargeback, reversal, adjustment, loyalty_in, loyalty_out, points_in, points_out, trophy, referral, direct_debit, direct_credit, direct_credit_return, recall debit for money leaving the account, credit for money arriving.
debit, credit When the transaction occurred. Default sort key.
Signed amount in the account currency. null only for rows with no amount yet.
Show child attributes
Show child attributes
Posted ledger balance of the account immediately after this transaction, ordered by transaction_at. Excludes pending holds.
Show child attributes
Show child attributes
When the transaction record was created.
When the transaction record was last updated.
(Optional) For transfer_* and exchange_* types, the other company account involved.
(Optional) Free-text payment reference.
(Optional) Payee identifier for outbound payments.
(Optional) Payment rail used, for example local.
(Optional) Payment purpose code where the rail requires one.
(Optional) Underlying payment provider.
(Optional) Reconciliation reference from the provider.
(Optional) When the transaction was authorised.
(Optional) When the transaction settled. Set once status is completed.
(Optional) For scheduled payments, when the payment is due to execute.
(Optional) Fee charged, as a negative amount in the account currency. Omitted when zero.
Show child attributes
Show child attributes
(Optional) Signed amount in the currency the transaction was made in.
Show child attributes
Show child attributes
(Optional) Signed amount in the company's base currency.
Show child attributes
Show child attributes
(Optional) transaction_amount / account_amount, present only when the two currencies differ. Six decimal places.
(Optional) Reward points earned or redeemed.
(Optional) Merchant details as received from the card network.
Show child attributes
Show child attributes
(Optional) Incard merchant identifier once the merchant has been recognised.
(Optional) Display details for a recognised merchant.
Show child attributes
Show child attributes
(Optional) Spend category UUID.
(Optional) Accounting code assigned to the transaction.
Show child attributes
Show child attributes
(Optional) UUID of the user who initiated the transaction.
(Optional) Included when user=true and user_id is set.
Show child attributes
Show child attributes
(Optional) Token of the card used, for card and atm types.
(Optional) Included when card=true and card_token is set.
Show child attributes
Show child attributes
(Optional) Trophy UUID for trophy rewards.
(Optional) Reason the transaction was declined.
(Optional) Note added by a team member.