Business API
Retrieve a list of counterparties
api
get
/counterparties

Retrieve a list of counterparties

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.

Request​

Query Parameters
Query Parameters

Response​

List of your counterparties

Response body
Body array of objects
Was this page helpful?
GET
/counterparties . 
Parameters
curl -L -X GET 'https://b2b.revolut.com/api/1.0/counterparties' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'
Response body samples
[
  {
    "id": "239d6f1f-2222-4ae6-1111-5cc603341b4e",
    "name": "Jane Doe Co.",
    "state": "created",
    "created_at": "2022-09-14T14:47:12.273718Z",
    "updated_at": "2022-09-14T14:47:12.273718Z",
    "accounts": [
      {
        "iban": "GB66REVO00996995908786",
        "bic": "REVOGB21",
        "id": "b209281b-aakk-9911-8d83-ac72469cef8f",
        "type": "external",
        "name": "Jane Doe Co.",
        "bank_country": "GB",
        "currency": "EUR"
      }
    ]
  },
  {
    "id": "8e0e9886-0af1-4b0c-acf4-111180d2892b",
    "name": "John Smith",
    "revtag": "johnsmith",
    "profile_type": "personal",
    "country": "GB",
    "state": "created",
    "created_at": "2022-09-14T14:41:39.312017Z",
    "updated_at": "2022-09-14T14:41:39.312017Z"
  },
  {
    "id": "e7e36cce-2e9c-4e96-818e-1c2fed325852",
    "name": "John Doe Co.",
    "state": "created",
    "created_at": "2022-08-14T14:34:11.168340Z",
    "updated_at": "2022-08-14T14:34:11.168340Z",
    "accounts": [
      {
        "account_no": "12345674",
        "sort_code": "540107",
        "id": "e277b2bd-3a6d-423b-933d-3d425094bb13",
        "type": "external",
        "name": "John Doe Co.",
        "bank_country": "GB",
        "currency": "GBP"
      }
    ]
  },
  {
    "id": "239d6f1f-2222-4ae6-1111-5cc603341b4e",
    "name": "John Smith Co.",
    "state": "created",
    "created_at": "2022-09-14T14:47:12.273718Z",
    "updated_at": "2022-09-14T14:47:12.273718Z",
    "accounts": [
      {
        "iban": "FR1420041010050500013M02606",
        "bic": "PSSTFRPPLIL",
        "id": "b209281b-aakk-9911-8d83-ac72469cef8f",
        "type": "external",
        "name": "John Smith Co.",
        "bank_country": "FR",
        "currency": "EUR"
      }
    ]
  },
  {
    "id": "173e6a6b-d955-465f-8f31-7f6f7c03927c",
    "name": "Johann Meier Co.",
    "state": "created",
    "created_at": "2023-08-10T12:43:20.273500Z",
    "updated_at": "2023-08-10T12:43:20.273500Z",
    "accounts": [
      {
        "iban": "CH5604835012345678009",
        "bic": "UBSWCHZH80A",
        "id": "b3cc43e8-f141-459b-9bd5-3505cf9797f8",
        "type": "external",
        "name": "Johann Meier Co.",
        "bank_country": "CH",
        "currency": "EUR"
      }
    ]
  },
  {
    "id": "1d9013c8-84bf-474c-b3d9-690f2ae2e65c",
    "name": "Jane Doe",
    "state": "created",
    "created_at": "2024-01-10T15:32:10.172300Z",
    "updated_at": "2024-01-10T15:32:10.172300Z",
    "cards": [
      {
        "id": "0130f363-eeaf-4aa8-b77f-a6a629c603f5",
        "name": "Jane Doe",
        "last_digits": 1234,
        "scheme": "visa",
        "country": "GB",
        "currency": "GBP"
      },
      {
        "id": "fa05f2e5-d253-4661-85cc-bcff98b136ac",
        "name": "Jane Doe",
        "last_digits": 5678,
        "scheme": "mastercard",
        "country": "GB",
        "currency": "GBP"
      }
    ]
  }
]