---
title: "Check counterparty field requirements"
method: GET
path: "/counterparties/fields"
tags: ["Counterparties"]
---

# Check counterparty field requirements

`GET /counterparties/fields`

## Request

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

Retrieve the list of conditionally required or applicable fields for creating a counterparty together with their constraints.

:::note [Note]
This feature is not available in Sandbox.
:::

When creating a counterparty via the [Create a counterparty endpoint](https://developer.revolut.com/docs/api/business#add-counterparty), certain fields (such as `first_name`, `last_name`, `company_name`, `tax_id`, `route`, or `account_type`) become required depending on the counterparty's bank country, currency, and profile type.
This read-only endpoint allows you to discover these contextual fields dynamically, along with their validation rules and available options.

Only the fields relevant to the specific context are returned.
The input parameters (`country`, `currency`, and `recipient_type`) are intentionally excluded from the response.

For more details, see the guide: **Check counterparty field requirements** section in [Create a counterparty](https://developer.revolut.com/docs/guides/manage-accounts/counterparties/create-a-counterparty#check-counterparty-field-requirements).

## Query parameters

- `country` string, required: 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.
- `recipient_type` 'personal' | 'business', required
- `route` string

## Response `200`

The applicable and conditionally required fields for creating the counterparty

- CounterpartyRequirementsResponse: The response containing applicable counterparty fields and their validation rules.
  - `fields` CounterpartyRequirementsField[], required: A list of applicable and conditionally required fields for the specific counterparty context.
    - `name` string, required: The name of the field to be provided in the [Create a counterparty endpoint](https://developer.revolut.com/docs/api/business#add-counterparty) request body. Matches the field names in the Create a counterparty endpoint exactly (e.g. `first_name`, `last_name`, `tax_id`, `route`, `account_type`).
    - `required` boolean, required: Indicates whether this field must be provided when creating the counterparty.
    - `regex` CounterpartyRequirementsFieldRegex: Regular expression validation rules.
      - `pattern` string, required: The regex pattern the field value must match.
      - `description` string, required: A human-readable description of the regex constraint.
    - `options` CounterpartyRequirementsFieldOption[]: A list of allowed values for the field (enum). If provided, the field value must be one of these options.
      - `value` string, required: The accepted value to be passed to the API.
      - `default` boolean: Indicates the default option for the field if there is one.

## Other responses

- `400`: Bad request For example: - missing or invalid query parameters - unsupported recipient type for country/currency combination
- `404`: Not found
- `422`: Unprocessable entity For example: - currency not supported for the given country
- `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)