# List connector accounts

Retrieves a paginated list of connector accounts registered under your account, newest first. This endpoint requires an account-level API key.

Endpoint: POST /connector-accounts/list
Version: 2.0.0
Security: bearerAuth

## Security:

  - `bearerAuth` (unknown)
    http bearer SECRET

## Request fields (application/json):

  - `filters` (object)
    Filters for connector accounts.

  - `filters.status` (object)
    Operator and value for connector account status filter.

  - `filters.status.operator` (string, required)
    Comparison operator.
    Enum: "EQ", "IN"

  - `filters.status.value` (string, required)
    Single connector account status for `EQ`, or a comma-separated list for `IN`. Allowed values are the `status` values of a connector account.
    Example: ACTIVE,INACTIVE

  - `filters.connector_id` (object)
    Operator and value for connector identifier filter.

  - `filters.connector_id.operator` (string, required)
    Comparison operator.
    Enum: "EQ", "IN"

  - `filters.connector_id.value` (string, required)
    Single connector identifier for `EQ`, or a comma-separated list for `IN`.
    Example: adyen

  - `filters.name` (object)
    Operator and value for connector account name filter.

  - `filters.name.operator` (string, required)
    Comparison operator. `CONTAINS` performs case-insensitive substring search.
    Enum: "CONTAINS"

  - `filters.name.value` (string, required)
    Part of the connector account name.
    Example: EU cards

  - `pagination` (object)
    Pagination details.

  - `pagination.page_size` (integer, required)
    Number of items returned in this response.
    Example: 20

  - `pagination.next_page_token` (string)
    Token to retrieve the next page of results. It is empty on the last page.
    Example: eyJMYXN0SUQiOiIxYTYyYjQ0Ni01ZDM0LTRiYTQtOGRlZS02NTM5NTU0NjY2MTQifQ==

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `items` (array)
    List of connector accounts for the current page.

  - `items.id` (string, required)
    Unique connector account identifier. Matches `connector_account_id` in routing configuration steps.
    Example: ca_01KRXP28JE4M5P6R7S8T9V0W1X

  - `items.name` (string, required)
    Connector account name.
    Example: Adyen EU cards

  - `items.status` (string, required)
    Connector account status.
The list of enum values may be extended without notice.
    Enum: "ACTIVE", "INACTIVE", "PENDING", "ARCHIVED"

  - `items.connector_id` (string, required)
    Identifier of the PSP or acquirer connector used for processing. Matches `connector_id` in routing configuration steps.
    Example: adyen

  - `items.legal_entity_id` (string)
    Identifier of the legal entity the connector account is registered for.
    Example: le_01JZ9F3H8KQWE5T6Y7R2M4N0BX

  - `items.website` (object)
    Merchant website the connector account is registered for.

  - `items.website.domain` (string, required)
    Website domain.
    Example: example.com

  - `items.acquiring_bank` (object)
    Acquiring bank that issued the connector account.

  - `items.acquiring_bank.name` (string, required)
    Acquiring bank name.
    Example: Adyen N.V.

  - `items.mcc` (string, required)
    Merchant category code assigned to the connector account.
    Example: 5815

  - `items.card_brands` (array)
    Card brands enabled for processing.
    Example: ["VISA","MASTERCARD"]

  - `items.processing_currencies` (object)
    Currency rules of the connector account.

  - `items.processing_currencies.enabled_currencies` (array)
    Currencies processed without conversion, in ISO 4217 alphabetic code.
    Example: ["EUR","USD"]

  - `items.processing_currencies.default_currency` (string)
    Currency in ISO 4217 alphabetic code to which payments in currencies not listed in `enabled_currencies` are converted.
    Example: EUR

  - `items.card_brand_processing_currencies` (array)
    Card brand currency rules. A rule fully replaces `processing_currencies` for payments with its card brand.
    Example: [{"card_brand":"MASTERCARD","enabled_currencies":["EUR"],"default_currency":"EUR"}]

  - `items.card_brand_processing_currencies.card_brand` (string)
    Card brand the rule applies to.
    Example: MASTERCARD

  - `items.payment_methods` (array)
    Payment methods the connector account can process.
    Example: ["CARD","APPLE_PAY","GOOGLE_PAY","NETWORK_TOKEN","COF","PSP_TOKEN"]

  - `items.payment_features` (array)
    Payment features enabled on the connector account.
    Example: ["NETWORK_TOKEN_FIRST","NETWORK_TOKEN_RECURRING","COF_PAN","AVS"]

  - `items.required_fields` (array)
    Payment fields that are mandatory for processing in certain regions and must be provided in the API request. If `ZIP_CODE` is listed, routing skips this connector account for card payments with a USA-issued card and no ZIP code.
    Example: ["ZIP_CODE"]

  - `items.default_recurring_strategy` (object)
    Default strategy for recurring payments through this connector account. It is used when no recurring routing configuration applies to the payment. Methods are tried in the listed order. Methods that the connector account does not support are skipped. If omitted, the platform default picks the first available method in this order: `PSP_TOKEN`, then `COF`.

  - `items.default_recurring_strategy.processing_methods` (array, required)
    Recurring processing methods in the order they are tried.
    Example: ["NETWORK_TOKEN","COF"]

  - `items.authentication_settings` (object, required)
    Authentication settings of the connector account, such as 3DS.

  - `items.authentication_settings.is_3ds_enabled` (boolean, required)
    Whether 3DS authentication is enabled.
    Example: true

  - `items.authentication_settings.is_3ri_enabled` (boolean, required)
    Whether 3RI authentication is enabled.
    Example: false

  - `items.authentication_settings.is_data_only_enabled` (boolean, required)
    Whether Data Only authentication is enabled.
    Example: false

  - `items.authentication_settings.is_sca_tra_exemption_enabled` (boolean, required)
    Whether the SCA TRA exemption can be requested. Required by routing steps with `is_sca_tra_exemption`.
    Example: true

  - `items.authentication_settings.is_3ds_cascading_enabled` (boolean, required)
    Whether a 3DS result can be reused when a payment cascades to another connector account.
    Example: false

  - `items.authentication_settings.providers` (array)
    Providers of 3DS authentication selected for the connector account.
    Example: ["CARDINAL_MPI","EXTERNAL_MPI"]

  - `items.descriptor_settings` (object, required)
    Statement descriptor settings of the connector account.

  - `items.descriptor_settings.type` (string, required)
    Descriptor type.
The list of enum values may be extended without notice.
    Enum: "STATIC", "DYNAMIC"

  - `items.descriptor_settings.default_value` (string)
    Descriptor issued with the connector account.
    Example: EXAMPLE.COM

  - `items.descriptor_settings.is_initial_payment_suffix_fallback_enabled` (boolean)
    Whether a recurring payment without a descriptor suffix uses the suffix of the initial payment. Returned only for `DYNAMIC` descriptors.
    Example: true

  - `items.descriptor_settings.prefix` (object)
    Prefix added before the dynamic descriptor body. The value for the card brand of the payment is used.

  - `items.descriptor_settings.prefix.card_brand_values` (array, required)
    Prefixes for specific card brands.
    Example: [{"card_brand":"VISA","value":"V*"}]

  - `items.descriptor_settings.prefix.card_brand_values.card_brand` (string, required)
    Card brand the prefix applies to.
    Example: VISA

  - `items.descriptor_settings.prefix.card_brand_values.value` (string, required)
    Prefix value.
    Example: V*

  - `items.created_at` (string, required)
    Date and time when the connector account was created.
    Example: 2026-05-18T13:58:02.062000Z

  - `items.updated_at` (string, required)
    Date and time when the connector account was last updated.
    Example: 2026-09-21T10:52:55.814000Z

  - `pagination` (object)
    Pagination details.

  - `pagination.page_size` (integer, required)
    Number of items returned in this response.
    Example: 20

  - `pagination.next_page_token` (string)
    Token to retrieve the next page of results. It is empty on the last page.
    Example: eyJMYXN0SUQiOiIxYTYyYjQ0Ni01ZDM0LTRiYTQtOGRlZS02NTM5NTU0NjY2MTQifQ==

## Response 400:

  - `400` (unknown)
    Bad request

## Response 400 fields (application/json):

  - `code` (string, required)
    Code identifying the error type.
    Enum: "VALIDATION"

  - `message` (string, required)
    Message describing the error.
    Example: One or more fields failed validation due to constraints

  - `context` (object, required)
    Additional context about the validation error, including specific constraints.
    Example: {"constraints":{"email":{"type":"TYPE","message":"The 'email' field must be a valid email address"},"age":{"type":"MIN","message":"The 'age' field must be a number greater than or equal to 18"}}}

  - `context.constraints` (object, required)
    Failed constraints keyed by the field name.

## Response 401:

  - `401` (unknown)
    Unauthenticated

## Response 401 fields (application/json):

  - `code` (string, required)
    Code identifying the error type.
    Enum: "UNAUTHENTICATED"

  - `message` (string, required)
    Message describing the error.
    Example: Credentials are invalid or missing

## Response 403:

  - `403` (unknown)
    Unauthorized

## Response 403 fields (application/json):

  - `code` (string, required)
    Code identifying the error type.
    Enum: "PERMISSION_DENIED"

  - `message` (string, required)
    Message describing the error.
    Example: Permission denied

## Response 429:

  - `429` (unknown)
    Too many requests

## Response 429 fields (application/json):

  - `code` (string, required)
    Code identifying the error type.
    Enum: "RATE_LIMIT"

  - `message` (string, required)
    Message describing the error.
    Example: Rate limit exhausted

  - `context` (object)
    Additional context about the error.

  - `context.next_try_at` (string)
    Timestamp indicating when to retry the request.
    Example: 2024-12-31T23:59:59.000000Z