Post International Search

Create a new international business search.

Preferstring nullable

Request execution preference (RFC 7240). Use respond-async for asynchronous execution, wait=N to specify a synchronous timeout hint in seconds, or priority=low to route the task to the low-priority queue.

Example:respond-async

Request execution preference (RFC 7240). Use respond-async for asynchronous execution, wait=N to specify a synchronous timeout hint in seconds, or priority=low to route the task to the low-priority queue.

Request body

namestring nullable

The name of the business to search for. Required (together with address) unless filing_number is provided.

addressstring nullable

The address of the business to search for. Required (together with name) unless filing_number is provided.

iso2_country_code'AR' | 'AU' | 'AT' | 'BE' | 'BR' | 'CA' | 'CZ' | 'DK' | 'FI' | 'FR' | 'DE' | 'IN' | 'IE' | 'IT' | 'JP' | 'KE' | 'LU' | 'MY' | 'MX' | 'NL' | 'NZ' | 'NG' | 'NO' | 'PL' | 'PT' | 'SA' | 'SK' | 'ES' | 'SE' | 'CH' | 'TR' | 'UA' | 'GB' required

Enumeration of ISO 3166-1 alpha-2 country codes supported for international searches.

This is a subset of ISO2CountryCode that includes only jurisdictions where international search capabilities are available.

filing_numberstring nullable

The company registration (filing) number to search for — for example the filing_number of a result picked from GET /international/registrations. When provided, the registry is searched by this number first; a name (if also provided) is used as a fallback when no company matches the number. A filing_number with iso2_country_code is a complete request on its own — name/address matching is skipped and the match fields stay null.

officer_namesstring[] nullable

The officer names to include in the search.

websitestring nullable

The website to include in the search.

phone_numberstring nullable

The phone number to include in the search.

emailstring nullable

The email to include in the search.

alternative_namesstring[] nullable

The alternative names to include in the search.

reference_idstring nullable

An optional reference ID to associate with the search request.

optionsInternationalBusinessSearchOptions[]

Optional, separately-billed add-ons to enable for this search.

Example request

{
  "name": "White, Floyd and Cook",
  "address": "1 Parliament St, London SW1A 2JR, United Kingdom",
  "filing_number": "09517735",
  "officer_names": [
    "Nathan Harrington",
    "Alexander Wolfe"
  ],
  "website": "https://www.figueroa.com/",
  "phone_number": "436-502-9710",
  "email": "zacharymoore@example.com",
  "alternative_names": [
    "Joe's Pizza",
    "Joe's Pizzeria"
  ],
  "reference_id": "Search1234",
  "options": [
    "Order.Enhanced"
  ]
}

Response

idstring uuid required

Unique identifier for the international business search.

state'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' required

namestring nullable

The name inputted in the search (null for filing-number-only searches).

addressstring nullable

The address string inputted in the search (null for filing-number-only searches).

iso2_country_code'AR' | 'AU' | 'AT' | 'BE' | 'BR' | 'CA' | 'CZ' | 'DK' | 'FI' | 'FR' | 'DE' | 'IN' | 'IE' | 'IT' | 'JP' | 'KE' | 'LU' | 'MY' | 'MX' | 'NL' | 'NZ' | 'NG' | 'NO' | 'PL' | 'PT' | 'SA' | 'SK' | 'ES' | 'SE' | 'CH' | 'TR' | 'UA' | 'GB'

Enumeration of ISO 3166-1 alpha-2 country codes supported for international searches.

This is a subset of ISO2CountryCode that includes only jurisdictions where international search capabilities are available.

filing_numberstring nullable

The company registration (filing) number inputted in the search.

reference_idstring nullable

The reference ID inputted in the search.

business_name_match'NO_MATCH' | 'SIMILAR' | 'EXACT'

business_address_match'NO_MATCH' | 'REGION' | 'CITY' | 'COUNTRY' | 'EXACT'

filing_number_matchboolean nullable

Whether the inputted filing number found the company at the registry. False means the search fell back to the name search; null means no filing number was provided.

created_atstring date-time required

The datetime the search was created.

updated_atstring date-time nullable

The datetime the search was updated at (generally when the search completed).

verifiedboolean nullable

Indicates whether the found business was a close enough match to be considered verified.

errorstring nullable

Any errors that occurred.

warningsstring[]

Any warnings that occurred.

optionsInternationalBusinessSearchOptions[]

Optional, separately-billed add-ons requested for this search.

urlstring uri required

The API URL to retrieve the search.

Example response

{
  "user": {
    "first_name": "Austin",
    "last_name": "Taylor",
    "email": "jessicasimpson@example.com"
  },
  "name": "Acme Corporation",
  "address": "1640 Riverside Drive, Hill Valley, CA",
  "search_address": {
    "premise": "221B",
    "thoroughfare": "Baker Street",
    "dependent_thoroughfare": "Marylebone Road",
    "locality": "London",
    "dependent_locality": "Westminster",
    "administrative_area": "England",
    "postal_code": "NW1 6XE",
    "country_iso_3": "GBR",
    "latitude": 51.5237,
    "longitude": -0.1585,
    "type": "Registered Office"
  },
  "filing_number": "09517735",
  "reference_id": "Search1234",
  "filing_number_match": true,
  "created_at": "2026-07-16T19:24:27.811868",
  "updated_at": "2026-07-16T19:24:27.811885",
  "verified": true,
  "scores": [
    {
      "score": 95,
      "rating": "A"
    }
  ],
  "options": [
    "Order.Enhanced"
  ],
  "business": {
    "name": "Acme Corporation",
    "file_number": "867124",
    "standing": "Registered",
    "legal_form": "ltd",
    "issue_date": "2024-01-01",
    "incorporation_date": "2024-01-01",
    "last_annual_account_date": "2024-01-01",
    "dissolution_date": "2024-01-01",
    "registration_authority": "Companies House, United Kingdom",
    "registration_authority_code": "CA-ON",
    "registration_type": "Federal",
    "registry_type": "Registered society",
    "addresses": [
      {
        "premise": "221B",
        "thoroughfare": "Baker Street",
        "dependent_thoroughfare": "Marylebone Road",
        "locality": "London",
        "dependent_locality": "Westminster",
        "administrative_area": "England",
        "postal_code": "NW1 6XE",
        "country_iso_3": "GBR",
        "latitude": 51.5237,
        "longitude": -0.1585,
        "type": "Registered Office"
      }
    ],
    "alternative_names": [
      "Ramos, Garcia and Good"
    ]
  },
  "url": "https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314"
}

v1

Post International Search

Headers

Request body

Example request

Response

Example response