Get the details of your transactions.:::noteAn incoming or outgoing payment is represented as a transaction.:::For more information, see the guides: [Retrieve transactions](https://developer.revolut.com/docs/guides/manage-accounts/accounts-and-transactions/retrieve-transactions).
Revolut Transactions API is one of 46 APIs that Revolut publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Transactions. The published artifact set on APIs.io includes an OpenAPI specification.
This API exposes
5 operations
across 5 paths,
and defines 39 schemas.
It is described by OpenAPI 3.0.1, at version 1.0.
Requests are made against 2 base URLs: https://b2b.revolut.com/api/1.0, https://sandbox-b2b.revolut.com/api/1.0.
5 operations5 paths39 schemas5 GET
Metadata
The identity and technical contract details declared by the specification.
Specification
OpenAPI 3.0.1
API Version
1.0
Base URL
https://b2b.revolut.com/api/1.0
Authentication
HTTP Bearer
Resource Areas
1
Authentication & Security 1
Revolut Transactions API declares
1 security scheme
for authenticating requests.
It accepts HTTP bearer tokens (AccessToken).
AccessToken — Each Business API request must contain an authorization header in the following format to make a call: Bearer . The access token will be obtained the first tim…
Paths & Operations 5
Across 5 paths, the API surfaces 5 operations — 5 GET. Each is listed below with its method, path, parameters, and response codes.
Transactions 5
Get the details of your transactions. :::note An incoming or outgoing payment is represented as a transaction. ::: For more information, see the guides: [Retrieve transactions](ht…
The contract defines 39 schemas that model the data the API accepts and returns. The most detailed are OBTransaction4 (17 properties), Transaction (14 properties), TransactionLeg (10 properties), OBStandingOrder4 (9 properties). Each schema is shown below with its type and property counts.
OBMerchantDetails1
object
The details of the merchant involved in the transaction.
1 property
OBReadTransaction4
object
3 properties3 required
OBExternalDirectDebitStatus1Code
string
The status of the direct debit.
OBSupplementaryData1
object
The additional information that cannot be captured in the structured fields and/or any other specific block.
Meta
object
Meta data relevant to the payload.
1 property
OBActiveOrHistoricCurrencyAndAmount
object
The amount of the cash balance after a transaction entry is applied to the account.
2 properties2 required
OBDirectDebit1
object
The account that a cash entry is made to or from.
6 properties3 required
AccountId
string
The unique and immutable ID to identify the account resource. This ID has no meaning to the account owner.
TransactionState
string
Indicates the transaction state. Possible values: - created: The transaction has been created and is either processed asynchronously or scheduled for a later t…
OBEntryStatus1Code
string
The status of a transaction entry on the books of the account servicer.
Currency
string
[ISO 4217](https://en.wikipedia.org/wiki/ISO4217) currency code in upper case.
OBReadDirectDebit1
object
3 properties3 required
Error
object
2 properties2 required
OBCashAccount5
object
The details to identify the account.
4 properties2 required
OBExternalStandingOrderStatus1Code
string
The status of the standing order.
OBStandingOrder4
object
A list of standing orders.
9 properties2 required
OBCurrencyExchange5
object
A list of elements to provide details on the currency exchange.
5 properties2 required
CardReference
object
Reference for the card. One of the name-value pairs assigned to the card for tracking. :::info Each time the card is used, the references are recorded in the […
2 properties2 required
TransactionType
string
Indicates the transaction type.
OBActiveCurrencyAndAmount_SimpleType
string
The amount of money where the unit of currency is explicit and compliant with [ISO 4217](https://en.wikipedia.org/wiki/ISO4217).
OBTransactionCashBalance
object
A list of elements used to define the balance as a numerical representation of the net increases and decreases in an account after a transaction entry is appli…
3 properties3 required
CountryCodeMerchant
string
The bank country of the merchant, provided as an [ISO 3166](https://en.wikipedia.org/wiki/ListofISO3166countrycodes) code. Typically 3 letters, though in some…
TransactionMerchant
object
The information about the merchant (only for card transactions).
5 properties
Transaction
object
14 properties6 required
TransactionCounterpartyAccountType
string
Indicates the type of the account.
OBBalanceType1Code
string
The balance type.
Transactions
array
OBErrorResponse1
object
The detailed information about the error to help troubleshooting.
4 properties3 required
Links
object
Links relevant to the payload.
3 properties1 required
OBCashAccount6
object
The unique ID of the account in the case of a transaction.
4 properties
OBReadStandingOrder4
object
3 properties3 required
TransactionInformation
string
The additional information of the transaction, which is unstructured text.
TransactionCard
object
The details of the card associated with the transaction.
6 properties
OBExternalAccountIdentification4Code
string
The name of the identification scheme.
OBError1
object
2 properties2 required
TransactionCounterparty
object
3 properties1 required
TransactionLeg
object
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 BGP accou…
10 properties4 required
OBRevolutAccountIdentificationCode
string
The name of the identification scheme. Note the scheme UK.Revolut.InternalAccountId is an internal account identifier for those accounts which don't have exter…
OBTransaction4
object
The details of the transaction.
17 properties5 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
