---
title: "Retrieve a list of counterparties"
method: GET
path: "/counterparties"
tags: ["Counterparties"]
---

# Retrieve a list of counterparties

`GET /counterparties`

## Request

- Base URL: `https://b2b.revolut.com/api/1.0`
- URL: `https://b2b.revolut.com/api/1.0/counterparties`
- Auth: HTTP bearer

Get all the counterparties that you have created, or use the query parameters to filter the results. 

The counterparties are sorted by the `created_at` date in reverse chronological order.

The returned counterparties are **paginated**. 
The maximum number of counterparties returned per page is specified by the `limit` parameter.
To get to the next page, make a new request and use the `created_at` date of the last counterparty returned in the previous response.

For more information, see the guides: [Retrieve counterparties](https://developer.revolut.com/docs/guides/manage-accounts/counterparties/retrieve-counterparties).

## Query parameters

- `name` string
- `account_no` string
- `sort_code` string
- `iban` string
- `bic` string
- `created_before` string, date-time
- `limit` integer

## Response `200`

List of your counterparties

- Counterparty[]
  - `id` string, uuid, required: The ID of the counterparty.
  - `name` string, required: The name of the counterparty.
  - `revtag` string: The [Revtag](https://help.revolut.com/help/transfers/internal-transfers/username-payments/revtags/) of the counterparty.
  - `profile_type` 'personal' | 'business': The type of the counterparty. Indicates whether the recipient is an individual or a company.
  - `country` string: The counterparty's bank country, provided as a 2-letter [ISO 3166](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) code.
  - `state` 'created' | 'draft' | 'deleted', required: Indicates the state of the counterparty.
  - `created_at` string, date-time, required: The date and time the counterparty was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `updated_at` string, date-time, required: The date and time the counterparty was last updated in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `accounts` CounterpartyAccount[]: The list of public accounts associated with this counterparty.
    - `id` string, uuid, required: The ID of the counterparty's account.
    - `name` string: The name of the counterparty.
    - `bank_country` string: The country of the bank, provided as a 2-letter [ISO 3166](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) code.
    - `currency` string, required: [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.
    - `type` 'revolut' | 'external', required: Indicates the type of account.
    - `account_no` string: The bank account number of the counterparty.
    - `iban` string: The IBAN number of the counterparty's account if applicable.
    - `sort_code` string: The sort code of the counterparty's account if applicable.
    - `routing_number` string: The routing number of the counterparty's account if applicable.
    - `bic` string: The BIC number of the counterparty's account if applicable.
    - `clabe` string: The CLABE number of the counterparty's account if applicable.
    - `ifsc` string: The IFSC number of the counterparty's account if applicable.
    - `bsb_code` string: The BSB number of the counterparty's account if applicable.
    - `route` 'ach' | 'fedwire' | 'swift': Routing method for US/USD transfers. Defaults to `ach` for US-registered businesses and `fedwire` for non-US businesses.
    - `bank_number` string: Brazilian bank identification code (COMPE). Returned for BR counterparties.
    - `branch_code` string: Brazilian branch (agência) code. Returned for BR counterparties.
    - `account_type` 'checking' | 'savings': Bank account type. Returned for BR, CO, and CL counterparties. Defaults to `checking` for US ACH transfers.
    - `tax_id` string: Tax identification number. Routed based on `bank_country` and recipient type: | Country | Recipient type | Tax ID type | Format | Example | |-----------|----------------------------------|-----------------------------------------------|-----------------------------------------------------|------------------------------------------| | **BR** | **Individual** | CPF (Cadastro de Pessoas Físicas) | `^\d{11}$` or `^\d{3}\.\d{3}\.\d{3}-\d{2}$` | `52998224725` or `529.982.247-25` | | **BR** | **Company** | CNPJ (Cadastro Nacional da Pessoa Jurídica) | `^\d{14}$` or `^\d{2}\.\d{3}\.\d{3}/\d{4}-\d{2}$` | `12345678000195` or `12.345.678/0001-95` | | **CO** | **Company** | NIT (Número de Identificación Tributaria) | `^\d{10}$` | `9012345678` | | **CL** | **Individual**, **Company** | RUT (Rol Único Tributario) | `^\d{7,8}[0-9Kk]$` | `12345678K` |
    - `national_id` string: National identification number. Specifies Colombian Cédula de Ciudadanía when `bank_country` is `CO` and `profile_type` is `personal`.
    - `phone` string: The phone number of the counterparty in [E.164](https://en.wikipedia.org/wiki/E.164) format. Country-specific formats: | Country | Format description | Format | Example | |---------|-----------------------------|-----------------|-----------------| | **CO** | `+57` followed by 10 digits | `^\+?57\d{10}$` | `+573001234567` | | **LK** | `+94` followed by 10 digits | `^\+?94\d{10}$` | `+941234567890` | | **KR** | `+82` followed by 10 digits | `^\+?82\d{10}$` | `+821012345678` |
    - `business_registration_id` string: Company registration number. Used for business LK counterparties.
    - `recipient_charges` 'no' | 'expected': Indicates the possibility of the recipient charges. :::warning This field is deprecated and should be disregarded. It is returned for legacy purposes only. :::
    - `address` CounterpartyAddress: The address of the counterparty's account.
      - `street_line1` string: Street line 1 information.
      - `street_line2` string: Street line 2 information.
      - `region` string: The name of the region (state or province), for example, Ontario for Canada.
      - `city` string: The name of the city.
      - `country` string, required: The country of the counterparty, as a 2-letter [ISO 3166](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) code.
      - `postcode` string: The postcode of the counterparty address.
  - `cards` CounterpartyCard[]: The list of cards associated with this counterparty.
    - `id` string, uuid, required: The ID of the counterparty's card.
    - `name` string, required: The name of the counterparty.
    - `last_digits` string, required: The last four digits of the card number.
    - `scheme` 'visa' | 'mastercard', required: The card brand.
    - `country` string, required: The country of the card issuer, provided as a 2-letter [ISO 3166](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) code.
    - `currency` string, required: [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.

## Other responses

- `400`: Bad Request
- `401`: Anauthorized
- `default`: Unexpected error

---

[API](https://skmtc.dev/revolut/apis/business-api.md) - [All operations](https://skmtc.dev/revolut/apis/business-api/llms.txt) - [OpenAPI document](https://skmtc.dev/revolut/apis/business-api/revisions/be089d9fa8b4?raw)