Searching internationally: by name & address, or by filing number

International Business Search accepts two ways to identify a business. Both require the country (iso2_country_code).

Name + address

The standard approach.

Provide the business name and address. This is all you need for the large majority of searches.

POST /international/searches
{ "name": "Acme Ltd", "address": "1 Parliament St, London SW1A 2JR, UK", "iso2_country_code": "GB" }

Registration / filing number

You can also search by the company's registration / filing number (filing_number). This is a good optional input to offer your users: in many countries, owners and finance staff know their registration number by heart (in Spain, for example, it's the CIF).

POST /international/searches
{ "filing_number": "01234567", "iso2_country_code": "GB" }

When you provide a filing_number, the registry is searched by that number first; a name, if also included, is used as a fallback if no company matches the number.

Tip: If you want to smooth out match rates in a specific market, you can look up candidates first with GET /international/registrations, let the user pick the right one, then search on that result's filing_number. This is optional, a plain name + address search works well on its own.

Same across profiles

Both search inputs work for Lite and Enhanced (Order.Enhanced) searches.

Related

• How International KYB differs from US

• Lite vs. Enhanced profiles