background image pattern

Developer news

News KYC API v2: Upcoming changes to addresses in all jurisdictions

KYC API v2: Upcoming changes to addresses in all jurisdictions

Posted 2025-09-24 | Updated 2025-10-01

Summary

We are pleased to share details of the upcoming enhancements to the contactInformation section of the dataset response, set to launch with October 1st release, including the addition of the new array called addresses available within refresh and super dataset on KYC API v2.

The revised addresses array will incorporate a new addressType field, which will accept values from a predefined set, along with a providedAddressTypethat will be mapped to the address type value received from the registry. Furthermore, the array will include both the complete address as a string and the fully formatted address when available. A list of address types is provided below:

Address Types

  • Registered address/Incorporation address/Legal address
  • Post(al) address
  • Operational address
  • Address abroad
  • Office address
  • Fiscal address
  • Trading address
  • Visiting address


We will begin populating the addresses array on a jurisdictional basis, starting with U.S. states as they have the highest number of addressTypes identified in our analysis. We will keep you informed with each release about which jurisdictions have been populated in this article.

The current address structure will remain unchanged for now to provide clients with time to adapt. During this transition period, users will continue to see the same address data in both the new addresses field and the existing address-related fields. Once data from all jurisdictions and sources has been fully integrated into the dataset, we will provide advance notice before retiring the legacy fields but not earlier than end of Q1 2026.

Adjusted jurisdictions

United States US

  • Alabama AL
  • Alaska AK
  • Arizona AZ
  • Arkansas AR
  • California CA
  • Colorado CO
  • Connecticut CT
  • District od Columbia DC
  • Florida FL
  • Georgia GA
  • Idaho ID
  • Illinois IL
  • Indiana IN
  • Iowa IA
  • Kansas KS
  • Kentucky KY
  • Louisiana LA
  • Maine ME
  • Massachusetts MA
  • Mississippi MS
  • Montana MT
  • Nebraska NE
  • Nevada NV
  • Tennessee TN


Please find the before and after responses below. Kindly note that the example companies mentioned are fictitious, and the availability of data fields in the mock-up is subject to the specific requirements of legal forms.


Intermediate response

"contactInformation": {
        "addresses": [
            {
            "addressType": "Registered address/Incorporation address/Legal address",
            "providedAddressType": "Registered address",
            "address": "c/o Eira Capital Oy, Keilalahdentie  2-4, ESPOO, 02150",
            "formattedAddress": {
                "careOf": "c/o Eira Capital Oy",
                "number": "2-4",
                "street": "Keilalahdentie",
                "city": "ESPOO",
                "zip": "02150"
            }
            }
        ],
        "contactAddress": "Kaisaniemenkatu, 4, HELSINGFORS, 00100",
        "formattedAddress": {
          "careOf": "c/o Eira Capital Oy",
          "number": "2-4",
          "street": "Keilalahdentie",
          "zip": "02150",
          "city": "ESPOO"
        }
      }

Response after

    "content":{
        "additionalData": {
            "contactInformation": {
                "email": null,
                "whateverElseWeHave...": null,
                "addresses": [
                    {
                        "addressType": "{addressType}",
                        "providedAddressType": "{providedAddressType}",
                        "address": [
                            "addressLine1",
                            "addressLine2",
                            "addressLine.."
                        ],
                        "formattedAddress": {
                            "addressLine1": "604 GALLATIN AVE, STE 206",
                            "zip": "372063476",
                            "city": "NASHVILLE",
                            "state": "TN",
                            "whateverElseWeHave": "bla"
                        }
                    }
                ]
            }



If you would like to provide us with feedback or you have a question related to this, don’t hesitate to contact us here: support team

Next