This guide details important updates to the data required when creating or updating customer accounts for our Sponsored Inhouse KYC API clients. These changes are being implemented to enhance data quality, ensure platform consistency, and meet evolving regulatory requirements.
These changes affect two processes:
1. Creating new accounts for your customers
2. Updating existing customer accounts
You will need to update your integration to send the required fields where they apply.
New mandatory fields
The following fields will become mandatory where applicable:
| Field | Applies to | Impacted Endpoints | Notes |
|---|---|---|---|
| Phone Number | Individuals and Corporates with the role “User” | POST /v1/forms/{form_id}/people PUT /v1/forms/{form_id}/ people/{person_id} | Must start with + followed by the country code. If the country code is +1 or +44, the phone number must contain 10 digits, excluding the country code. |
Collection Currencies collection_ | Individuals and Corporates with the role “User” | PUT /v1/forms/ {form_id}/account_usage | Three-character ISO currency codes |
Payment Currencies payment_ | Individuals and Corporates with the role “User” | PUT /v1/forms/ {form_id}/account_usage | Three-character ISO currency code |
Country of citizenship citizenship | Individuals and Corporates with the role “User” | POST /v1/forms/ {form_id}/people PUT /v1/forms/ {form_id}/people/{person_id} | Two-character ISO Country Code |
SSN id_number | Individuals and Corporates, US only, with the role “User” | POST /v1/forms/ {form_id}/people PUT /v1/forms/ {form_id}/people/{person_id} | Total length must be 9 characters |
Transaction Countries transaction_ | Individuals and Corporates with the role “User” | PUT /v1/forms/{form_id}/account_usage | Two-character ISO Country Code |
The new fields are available now and remain optional until 30 October 2026. From that date, they will become mandatory where they apply.
To avoid disruption, we strongly recommend that you update and test your integration as early as possible.
Timeline
| Milestone | Date |
|---|---|
| New fields available as optional fields | Now |
| All fields become mandatory where they apply | 30 October 2026 |