RErevolut
Accounts

Retrieve all account's beneficiaries

Changed on

Get all the beneficiaries of a specific user account.

:::note In compliance with PSD2 SCA regulations, access to this endpoint is only allowed within the first 5 minutes after the Revolut user has authorised the consent. After those 5 minutes, access to this endpoint is denied, and an HTTP 403 error is returned. :::

See also Tutorials: Get account and transaction information.

get/accounts/{AccountId}/beneficiaries

Request

  • Base URL
    https://oba-auth.revolut.com
  • Auth
    API key in header Authorization

Path parameters

AccountIdstring required

The ID of the account.

Query parameters

createdAfterstring date-time
Example:2025-10-09T00:00:00Z

The UTC ISO 8601 Date Time used for pagination. If the parameter is provided, only results created after the provided timestamp will be returned up to the maximum page size.

The value to be provided in this parameter will be returned in the Links.Next field only if it is required to retrieve more results.

Headers

x-fapi-financial-idstring required

The unique ID of the ASPSP that the request is issued to. The ID of Revolut is 001580000103UAvAAM.

x-fapi-customer-last-logged-timestring

The date and time when the PSU last logged in with the TPP.

All dates in the HTTP headers are represented as RFC 7231 Full Dates. For example: <nobr>Sun, 10 Sep 2017 19:43:31 UTC</nobr>.

x-fapi-customer-ip-addressstring

The IP address of the PSU if the PSU is logged in with the TPP.

x-fapi-interaction-idstring

An RFC4122 UUID used as a correlation ID.

Authorizationstring required

The access token that you've generated. For more information, see Generate an access token.

x-customer-user-agentstring

The user agent that the PSU is using.

Response

Beneficiaries Read

Example response

{
  "Data": {
    "Beneficiary": [
      {
        "CreditorAccount": {
          "SchemeName": "UK.OBIE.IBAN"
        }
      }
    ]
  }
}

Changes