Create a counterparty

To make a fund transfer or payment, add the counterparty that you intend to transact with.

Depending on which country a counterparty account is based in, the fields that you need to specify are different.

See also how to validate an account name (CoP) when adding a counterparty (UK only).

Add a UK counterparty​

If a counterparty has a UK bank account, the following details are required:

{
  "city":"London",
  "street_line1":"20 Upping St",
  "country":"GB",
  "postcode":"SW1A 2AB"
}

curl -X POST https://b2b.revolut.com/api/1.0/counterparty \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <your access token>' \
  -d '{
        "company_name": "John Smith Co.",
        "bank_country": "GB",
        "currency": "GBP",
        "account_no": "12345678",
        "sort_code": "223344",
        "address": {
          "city":"London",
          "street_line1":"20 Upping St",
          "country":"GB",
          "postcode":"SW1A 2AB"
        }
      }'

To see more example requests and responses:

Add an international counterparty​

If a counterparty has a non-UK bank account, depending on the country that the account is based in, you must specify the required fields.

See an example for an IBAN bank account.

curl -X POST https://b2b.revolut.com/api/1.0/counterparty \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <your access token>' \
  -d '{
        "company_name": "John Smith Co.",
        "bank_country": "FR",
        "currency": "EUR",
        "iban": "FR1420041010050500013M02606"
      }'

To see more example requests and responses:

Add a Revolut counterparty​

If a counterparty has a Revolut account, you can provide their Revtag and name.

curl -X POST https://b2b.revolut.com/api/1.0/counterparty \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <your access token>' \
  -d '{
        "profile_type": "personal",
        "name": "John Doe",
        "revtag": "johndoe"
      }'

To see more example requests and responses:

Alternatively, add a Revolut counterparty by providing their full details.

Required details depending on the country​

Check the following tables for the different required fields depending on the country.

Fields for US USD accounts​

Fields for IBAN countries​

Fields for SWIFT​

Fields for SWIFT MX​

Fields for IN INR accounts​

Fields for AU AUD accounts​

{
  "city":"Sydney",
  "street_line1":"21 Woolfe St",
  "country":"AU",
  "postcode":"NSW 2000"
}

Test accounts for Sandbox​

In the Sandbox environment, you cannot add real people and businesses as Revolut counterparties. To simulate Create a counterparty requests, use one of the test accounts.