Retrieve a transaction

Retrieve the details of a specific transaction. The details can include, for example, cardholder details for card payments.

You can retrieve a transaction with its details either by its transaction ID or by the request ID that was provided for this transaction at the time of its creation, for example, when you created a payment.

To retrieve a transaction by its transaction ID, use:
```
/transaction/\{transaction_id\}
```
To retrieve a transaction by a request ID provided at transaction creation, use:
```
/transaction/\{request_id\}?id_type=request_id
```

For more details, see the guides: Retrieve transaction data.

Request

Response

The information about a specific transaction

Response body

Body object

The ID of the transaction.

Possible values: [atm, card_payment, card_refund, card_chargeback, card_credit, exchange, transfer, loan, fee, refund, topup, topup_return, tax, tax_refund]

Indicates the transaction type.

The request ID that you provided previously.

Possible values: [created, pending, completed, declined, failed, reverted]

Indicates the transaction state. Possible values:

created: The transaction has been created and is either processed asynchronously or scheduled for a later time.
pending: The transaction is pending until it's being processed. If the transfer is made between Revolut accounts, this state is skipped and the transaction is executed instantly.
completed: The transaction was successful.
declined: The transaction was unsuccessful. This can happen for a variety of reasons, for example, insufficient account balance, wrong receiver information, etc.
failed: The transaction was unsuccessful. This can happen for a variety of reasons, for example, invalid API calls, blocked payments, etc.
reverted: The transaction was reverted. This can happen for a variety of reasons, for example, the receiver being inaccessible.

The reason code when the transaction state is declined or failed.

The date and time the transaction was created in ISO 8601 format.

The date and time the transaction was last updated in ISO 8601 format.

The date and time the transaction was completed in ISO 8601 format. This is required when the transaction state is completed.

The scheduled date of the payment, if applicable. Provided in ISO 8601 format.

The ID of the original transaction to which this transaction is related. Returned, for example, when this transaction is a refund of the related transaction, or for transactions related to cashback.

The information about the merchant (only for card transactions).

The payment reference.

The legs of the transaction:

For transactions between your Revolut accounts, there can be 2 legs, for example, an internal transfer made out of the GBP account and into the EUR account.
For transactions in other cases, there is only 1 leg.

The ID of the leg.

The amount of the transaction.

The amount of the transaction fee.

Pattern: Value must match regular expression ^[A-Z]{3}$

ISO 4217 currency code in upper case.

The billing amount for cross-currency payments.

Pattern: Value must match regular expression ^[A-Z]{3}$

ISO 4217 currency code in upper case.

The ID of the account that the transaction is associated with.

TransactionCounterparty

The transaction leg purpose.

The total balance of the account that the transaction is associated with.

The details of the card associated with the transaction.

The ID of the card.

The masked card number.

The first name of the cardholder.

The last name of the cardholder.

The phone number of the cardholder in E.164 format.

Possible number of items: non-empty and <= 5 items

Card references (references).

Retrieve a transaction

Request​

Response​

Request

Response