RErevolut
Transactions

Retrieve a list of transactions

Retrieve the historical transactions based on the provided query criteria.

The transactions are sorted by the created_at date in reverse chronological order, and they're paginated. The maximum number of transactions returned per page is specified by the count parameter. To get the next page of results, make a new request and use the created_at date from the last item of the previous page as the value for the to parameter.

:::note The API returns a maximum of 1,000 transactions per request. :::

For more details, see the guides: Retrieve transactions.

get/transactions

Request

  • Base URL
    https://b2b.revolut.com/api/1.0
  • Auth
    HTTP bearer

Query parameters

fromstring date-time or date

The date and time you retrieve the historical transactions from, including this date-time. Corresponds to the created_at value of the transaction. Provided in ISO 8601 format.

Used also for pagination. To get back to the previous page of results, make a new request and use the created_at date from the first item of the current page as the value for the from parameter.

tostring date-time or date

The date and time you retrieve the historical transactions to, excluding this date-time. Corresponds to the created_at value of the transaction. Provided in ISO 8601 format. The default value is the date and time at which you're calling the endpoint.

Used also for pagination. To get the next page of results, make a new request and use the created_at date from the last item of the previous (current) page as the value for the to parameter.

accountstring uuid

The ID of the account

countinteger

The maximum number of the historical transactions to retrieve per page.

To get the next page of results, make a new request and use the created_at date from the last item of the previous page as the value for the to parameter.

type'atm' | 'card_payment' | 'card_refund' | 'card_chargeback' | 'card_credit' | 'charge' | 'charge_refund' | 'exchange' | 'transfer' | 'loan' | 'fee' | 'refund' | 'topup' | 'topup_return' | 'tax' | 'tax_refund' | 'rev_payment'

Indicates the transaction type.

The type of the historical transactions to retrieve.

request_idstring
Example:invoice00912345

The request ID provided when the transaction was created. Lets you filter transactions related to that ID.

When provided, the from query parameter is also required, and the search interval must not exceed 14 days. For older transactions, adjust the to parameter as well.

statestring[]

The transaction state(s) to filter by.

To specify multiple values, follow this pattern: state={VALUE1}&state={VALUE2}.

Response

List of historical transactions retrieved

idstring required

The ID of the transaction.

type'atm' | 'card_payment' | 'card_refund' | 'card_chargeback' | 'card_credit' | 'charge' | 'charge_refund' | 'exchange' | 'transfer' | 'loan' | 'fee' | 'refund' | 'topup' | 'topup_return' | 'tax' | 'tax_refund' | 'rev_payment' required

Indicates the transaction type.

request_idstring

The request ID that you provided previously.

state'created' | 'pending' | 'completed' | 'declined' | 'failed' | 'reverted' required

Indicates the transaction state. Possible values:

ValueDescription
createdThe transaction has been created and is either processed asynchronously or scheduled for a later time.
pendingThe 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.
completedThe transaction was successful.
declinedThe transaction was unsuccessful. This can happen for a variety of reasons, for example, insufficient account balance, wrong receiver information, etc.
failedThe transaction was unsuccessful. This can happen for a variety of reasons, for example, invalid API calls, blocked payments, etc.
revertedThe transaction was reverted. This can happen for a variety of reasons, for example, the receiver being inaccessible.
reason_codestring

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

created_atstring date-time required

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

updated_atstring date-time required

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

completed_atstring date-time

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

scheduled_forstring date

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

related_transaction_idstring uuid

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.

referencestring

The payment reference.

auth_codestring

The authorization code from the card network. Returned for card transactions when the authorization code is available.

Example response

[
  {
    "merchant": {
      "name": "Acme Corp.",
      "full_name": "ACME*1234MN1HA2"
    },
    "card": {
      "references": [
        {
          "name": "PNR",
          "value": "RT12345"
        }
      ]
    }
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.