---
api: 'Business API'
---

# Check counterparty field requirements

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).

## Endpoint

GET `/counterparties/fields`

## Parameters

### query parameters

- `country` (string, required)
  The country where the counterparty's bank account is located.

- `currency` (string, required)
  The currency of the counterparty's bank account.

- `recipient_type` (enum, required)
  The type of the counterparty profile.
  Indicates whether the counterparty is a personal or business account.
  Possible enum values:

  - `personal`
  - `business`

- `route` (string, optional)
  The routing method for the corridor. 
  When omitted, the response includes fields for the default route.
  For example, for USD to US, the default is `ach`.

## Returns

### 200

The applicable and conditionally required fields for creating the counterparty

#### Response attributes

- `fields` (array of object)
    A list of applicable and conditionally required fields for the specific counterparty context.
  - `fields[].name` (string)
      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`).
  - `fields[].required` (boolean)
      Indicates whether this field must be provided when creating the counterparty.
  - `fields[].regex` (object, optional)
      Regular expression validation rules.
    - `fields[].regex.pattern` (string)
        The regex pattern the field value must match.
    - `fields[].regex.description` (string)
        A human-readable description of the regex constraint.
  - `fields[].options` (array of object, optional)
      A list of allowed values for the field (enum).
      If provided, the field value must be one of these options.
    - `fields[].options[].value` (string)
        The accepted value to be passed to the API.
    - `fields[].options[].default` (boolean, optional)
        Indicates the default option for the field if there is one.

## Error responses

| HTTP status code | Description |
| --- | --- |
| 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 |