Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Revolut Accounts API

Get the balances, full banking details, and other details of your business accounts. For more information, see the guides: [Get your account details](https://developer.revolut.com/docs/guides/manage-accounts/accounts-and-transactions/manage-your-accounts).

Revolut Accounts API is one of 46 APIs that Revolut publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Accounts. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 9 operations across 8 paths, and defines 36 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.

9 operations 8 paths 36 schemas 1 DELETE7 GET1 POST

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 Accounts 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 9

Across 8 paths, the API surfaces 9 operations — 1 DELETE, 7 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Accounts 9

Get the balances, full banking details, and other details of your business accounts. For more information, see the guides: [Get your account details](https://developer.revolut.com…

GET
/accounts
Retrieve all accounts
getAccounts → 200default
GET
/accounts/{account_id}
Retrieve an account
getAccount 1 param → 200default
GET
/accounts/{account_id}/bank-details
Retrieve account's full bank details
getAccountDetails 1 param → 200default
POST
/account-access-consents
Create an account access consent
CreateAccountAccessConsents 6 params body → 201400401403405406415429
GET
/account-access-consents/{ConsentId}
Retrieve an account access consent
GetAccountAccessConsentsConsentId 7 params → 200400401403405406429500
DELETE
/account-access-consents/{ConsentId}
Delete an account access consent
DeleteAccountAccessConsentsConsentId 7 params → 204400401403405406429500
GET
/accounts/{AccountId}
Retrieve an account
GetAccountsAccountId 7 params → 200400401403405406429500
GET
/accounts/{AccountId}/balances
Retrieve an account balance
GetAccountsAccountIdBalances 7 params → 200400401403405406429500
GET
/accounts/{AccountId}/beneficiaries
Retrieve all account's beneficiaries
GetAccountsAccountIdBeneficiaries 7 params → 200400401403405406429500

Schemas 36

The contract defines 36 schemas that model the data the API accepts and returns. The most detailed are AccountBankDetailsItem (12 properties), Account (8 properties), BeneficiaryAddress (6 properties), OBAccount3 (6 properties). Each schema is shown below with its type and property counts.

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 properties 2 required
AccountId
string
The unique and immutable ID to identify the account resource. This ID has no meaning to the account owner.
OBExternalPermissions1Code
string
The type of data access to the account.
OBExternalAccountSubType1Code
string
The sub-type of the account.
OBCashAccount5
object
The details to identify the account.
4 properties 2 required
Error
object
2 properties 2 required
OBReadBeneficiary3
object
3 properties 3 required
EstimatedTime
object
The estimated time of the inbound transfer of the funds, i.e. when we expect the recipient to receive the transfer.
3 properties 1 required
OBReadBalance1
object
3 properties 3 required
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).
AccountCurrency
string
[ISO 4217](https://en.wikipedia.org/wiki/ISO4217) currency code in upper case.
OBAccount3
object
The unique ID of the account that credit and debit entries are made to.
6 properties 4 required
OBReadData1
object
4 properties 1 required
OBBalanceType1Code
string
The balance type.
OBCashBalance1
object
A list of elements to define the balance details.
6 properties 5 required
OBExternalRequestStatus1Code
string
The status of the account access consent.
Accounts
array
OBExternalAccountType1Code
string
The type of the account.
OBCreditLine1
object
Set of elements used to provide details on the credit line.
3 properties 1 required
OBReadConsent1
object
2 properties 2 required
OBErrorResponse1
object
The detailed information about the error to help troubleshooting.
4 properties 3 required
OBBeneficiary3
object
3 properties
Links
object
Links relevant to the payload.
3 properties 1 required
PaymentSystem
string
Indicates the payment scheme used to execute transactions.
OBReadAccount3
object
3 properties 3 required
OBReadConsentResponse1
object
4 properties 4 required
AccountBankDetailsItem
object
12 properties 4 required
AccountBankDetailsItems
array
Indicates the payment scheme used to execute transactions.
OBRisk2
object
The Risk section contains the risk indicators that the initiating party sends to the [ASPSP](https://developer.revolut.com/docs/guides/build-banking-apps/gloss…
OBExternalLimitType1Code
string
The limit type.
OBError1
object
2 properties 2 required
BeneficiaryAddress
object
The address of the counterparty.
6 properties 2 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…
BankCountryCode
string
The country of the bank, provided as a 2-letter [ISO 3166](https://en.wikipedia.org/wiki/ListofISO3166countrycodes) code.
Account
object
8 properties 7 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

revolut-accounts-api-openapi.yml Raw ↑

Other APIs Revolut publishes across the network.

Revolut Accounting API
Revolut Accounting categories API
Revolut Apple Pay merchant registration API
Revolut Applications API
Revolut Balance API
Revolut Card invitations API
Revolut Cards API
Revolut Configuration API
Revolut Counterparties API
Revolut Customers API
Revolut Disputes API
Revolut Domestic payment API