Field Validation by Country

This guide covers the field formats, conditional requirements, and validation rules that vary by country or business context across the registration and capital account APIs.

Supported Countries

The following ISO 3166-1 alpha-3 country codes are accepted. All country fields must use the 3-letter code — full country names are not accepted.

Sending a country code that is not supported for your partnership will return a FORBIDDEN_GEO error.

Address Fields

All address fields use the same structure across registeredAddress, tradingAddress, and contact residences.

country

Must be a 3-letter ISO 3166-1 alpha-3 code. The field does not accept full country names.

{ "country": "GBR" }

state

Must be an ISO 3166-2 subdivision code. Full state names (e.g. California) are not accepted.

postCode

lineOne / lineTwo

PO Box addresses are not accepted in either line. This includes patterns such as P.O. Box, Post Office Box, GPO Box, and BFPO. Providing one returns a PO_BOX_NOT_ALLOWED error.

Bank Details

The required bank detail fields differ by country.

Company Registration Number

Whether registrationNumber is required depends on the businessType.

Required for these business types

Not required for these business types

SOLE_PROPRIETOR, PARTNERSHIP, GENERAL_PARTNERSHIP

For SOLE_PROPRIETOR, registrationNumber must be omitted or null. Providing one returns a 400 error.

Format by country

Maximum length: 50 characters.

All Business Types

PARTNERSHIP
GENERAL_PARTNERSHIP
LIMITED_PARTNERSHIP
LIMITED_LIABILITY_PARTNERSHIP
CORPORATION
LLC
SOLE_PROPRIETOR
ASSOCIATION
CIVIL_LAW_PARTNERSHIP
COOPERATIVE
FOREIGN_CORPORATION
FOREIGN_SOLE_TRADER
OTHER_PUBLIC_ENTITY
NON_PROFIT_ORGANISATION
PUBLIC_LIMITED_COMPANY
PUBLIC_LIMITED_COMPANY_AND_LIMITED_PARTNERSHIP
PRIVATE_CORPORATION
PUBLIC_CORPORATION
LIMITED_COMPANY

Company Name Fields

businessStartDate

Must not be a future date. Format: YYYY-MM-DD (ISO 8601). Use null or omit if unknown.

Contacts

Primary contact

Exactly one contact must have isPrimaryContact: true. Providing zero or more than one primary contact returns a 400 error.

Ownership percentage

For SOLE_PROPRIETOR business types, ownershipPercentage is not required and defaults to 100.

Email addresses

• Must be a valid RFC-compliant email address.
• All contacts must have unique email addresses (comparison is case-insensitive).
• Duplicate email addresses across contacts return a 400 error.

Identification numbers (USA partners)

For partnerships operating in the USA, all contacts must provide a Social Security Number (SSN).

For partnerships not operating in the USA, providing identification numbers returns a 400 error.

Industry Category

The industryCategory field is accepted but not yet processed. It is expected to become required in a future release.

Each entry requires a scheme and a code:

Error Reference