v1

latestOpenAPI 3.1.02026-07-241695611.0 MB

Webhook Events

InternationalBusinessSearch.submitted

Emitted when an International Business search has been submitted for processing.

postWebhookInternationalBusinessSearch.submitted

Payload

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 payload

{
  "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"
}

Response

Successful Response

{"stackTrail":"webhooks:InternationalBusinessSearch.submitted:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}