International business search submitted

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2026-08-31T10:31:07.837093",
  "url": "https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314",
  "__event__": {
    "type": "InternationalBusinessSearch.submitted",
    "origin": "api"
  },
  "user": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "first_name": "Austin",
    "last_name": "Taylor",
    "email": "jessicasimpson@example.com"
  },
  "name": "Acme Corporation",
  "address": "1640 Riverside Drive, Hill Valley, CA",
  "iso2_country_code": "GB",
  "search_address": {
    "locality": "London",
    "country_iso_3": "GBR",
    "premise": "221B",
    "thoroughfare": "Baker Street",
    "dependent_thoroughfare": "Marylebone Road",
    "dependent_locality": "Westminster",
    "administrative_area": "England",
    "postal_code": "NW1 6XE",
    "latitude": 51.5237,
    "longitude": -0.1585,
    "type": "Registered Office"
  },
  "filing_number": "09517735",
  "reference_id": "Search1234",
  "business_name_match": "EXACT",
  "business_address_match": "EXACT",
  "filing_number_match": true,
  "updated_at": "2026-08-31T10:31:07.837103",
  "verified": true,
  "scores": [
    {
      "type": "risk",
      "score": 95,
      "rating": "A"
    }
  ],
  "error": "<string>",
  "warnings": "Address validation is unavailable.",
  "options": [
    "Order.Enhanced"
  ],
  "business": {
    "name": "Acme Corporation",
    "file_number": "867124",
    "status": "active",
    "country": "GB",
    "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",
    "dissolved": false,
    "registration_authority": "Companies House, United Kingdom",
    "registration_authority_code": "CA-ON",
    "registration_type": "Federal",
    "registry_type": "Registered society",
    "addresses": {
      "administrative_area": "CA",
      "country_iso_3": "USA",
      "dependent_locality": null,
      "dependent_thoroughfare": null,
      "full_address": "123, Main St, Anytown, CA, 12345, USA",
      "latitude": 37.7749,
      "locality": "Anytown",
      "longitude": -122.4194,
      "postal_code": "12345",
      "premise": "123",
      "thoroughfare": "Main St",
      "type": null
    },
    "alternative_names": [
      "Ramos, Garcia and Good"
    ],
    "officers": [
      {
        "name": "<string>",
        "date_of_birth": "2023-12-25",
        "nationality": "<string>",
        "place_of_residence": "<string>",
        "place_of_birth": "<string>",
        "address": "<string>",
        "id_number": "<string>",
        "registration_number": "<string>",
        "titles": [
          "<string>"
        ],
        "is_active": true,
        "powers": [
          "<string>"
        ],
        "start_date": "2023-12-25",
        "end_date": "2023-12-25",
        "directorships": [
          {
            "company_name": "<string>",
            "company_number": "<string>",
            "title": "<string>",
            "is_active": true
          }
        ]
      }
    ],
    "beneficial_owners": [
      {
        "name": "<string>",
        "date_of_birth": "2023-12-25",
        "nationality": "<string>",
        "place_of_residence": "<string>",
        "place_of_birth": "<string>",
        "address": "<string>",
        "id_number": "<string>",
        "registration_number": "<string>",
        "nature_of_control": [
          "<string>"
        ],
        "notified_date": "2023-12-25",
        "kind": "<string>",
        "start_date": "2023-12-25"
      }
    ],
    "shareholders": [
      {
        "name": "<string>",
        "date_of_birth": "2023-12-25",
        "nationality": "<string>",
        "place_of_residence": "<string>",
        "place_of_birth": "<string>",
        "address": "<string>",
        "id_number": "<string>",
        "registration_number": "<string>",
        "percentage": "<string>",
        "share_count": 123,
        "total_nominal_value": 123,
        "share_class": "<string>",
        "beneficially_held": true
      }
    ],
    "share_capital": [
      {
        "class_code": "<string>",
        "class_description": "<string>",
        "quantity": 123,
        "unit_nominal_value": 123,
        "currency": "<string>",
        "total_nominal_value": 123,
        "voting_rights": "<string>"
      }
    ],
    "contact": {
      "email": "<string>",
      "phone": "<string>",
      "fax": "<string>",
      "website": "<string>"
    },
    "identifiers": {
      "tax_id": "<string>",
      "secondary_registration_number": "<string>",
      "other_identifiers": [
        "<string>"
      ]
    },
    "activities": [
      {
        "code": "<string>",
        "description": "<string>"
      }
    ],
    "registered_agent": {
      "name": "<string>",
      "address": "<string>"
    }
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

WEBHOOK

InternationalBusinessSearch.submitted

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2026-08-31T10:31:07.837093",
  "url": "https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314",
  "__event__": {
    "type": "InternationalBusinessSearch.submitted",
    "origin": "api"
  },
  "user": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "first_name": "Austin",
    "last_name": "Taylor",
    "email": "jessicasimpson@example.com"
  },
  "name": "Acme Corporation",
  "address": "1640 Riverside Drive, Hill Valley, CA",
  "iso2_country_code": "GB",
  "search_address": {
    "locality": "London",
    "country_iso_3": "GBR",
    "premise": "221B",
    "thoroughfare": "Baker Street",
    "dependent_thoroughfare": "Marylebone Road",
    "dependent_locality": "Westminster",
    "administrative_area": "England",
    "postal_code": "NW1 6XE",
    "latitude": 51.5237,
    "longitude": -0.1585,
    "type": "Registered Office"
  },
  "filing_number": "09517735",
  "reference_id": "Search1234",
  "business_name_match": "EXACT",
  "business_address_match": "EXACT",
  "filing_number_match": true,
  "updated_at": "2026-08-31T10:31:07.837103",
  "verified": true,
  "scores": [
    {
      "type": "risk",
      "score": 95,
      "rating": "A"
    }
  ],
  "error": "<string>",
  "warnings": "Address validation is unavailable.",
  "options": [
    "Order.Enhanced"
  ],
  "business": {
    "name": "Acme Corporation",
    "file_number": "867124",
    "status": "active",
    "country": "GB",
    "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",
    "dissolved": false,
    "registration_authority": "Companies House, United Kingdom",
    "registration_authority_code": "CA-ON",
    "registration_type": "Federal",
    "registry_type": "Registered society",
    "addresses": {
      "administrative_area": "CA",
      "country_iso_3": "USA",
      "dependent_locality": null,
      "dependent_thoroughfare": null,
      "full_address": "123, Main St, Anytown, CA, 12345, USA",
      "latitude": 37.7749,
      "locality": "Anytown",
      "longitude": -122.4194,
      "postal_code": "12345",
      "premise": "123",
      "thoroughfare": "Main St",
      "type": null
    },
    "alternative_names": [
      "Ramos, Garcia and Good"
    ],
    "officers": [
      {
        "name": "<string>",
        "date_of_birth": "2023-12-25",
        "nationality": "<string>",
        "place_of_residence": "<string>",
        "place_of_birth": "<string>",
        "address": "<string>",
        "id_number": "<string>",
        "registration_number": "<string>",
        "titles": [
          "<string>"
        ],
        "is_active": true,
        "powers": [
          "<string>"
        ],
        "start_date": "2023-12-25",
        "end_date": "2023-12-25",
        "directorships": [
          {
            "company_name": "<string>",
            "company_number": "<string>",
            "title": "<string>",
            "is_active": true
          }
        ]
      }
    ],
    "beneficial_owners": [
      {
        "name": "<string>",
        "date_of_birth": "2023-12-25",
        "nationality": "<string>",
        "place_of_residence": "<string>",
        "place_of_birth": "<string>",
        "address": "<string>",
        "id_number": "<string>",
        "registration_number": "<string>",
        "nature_of_control": [
          "<string>"
        ],
        "notified_date": "2023-12-25",
        "kind": "<string>",
        "start_date": "2023-12-25"
      }
    ],
    "shareholders": [
      {
        "name": "<string>",
        "date_of_birth": "2023-12-25",
        "nationality": "<string>",
        "place_of_residence": "<string>",
        "place_of_birth": "<string>",
        "address": "<string>",
        "id_number": "<string>",
        "registration_number": "<string>",
        "percentage": "<string>",
        "share_count": 123,
        "total_nominal_value": 123,
        "share_class": "<string>",
        "beneficially_held": true
      }
    ],
    "share_capital": [
      {
        "class_code": "<string>",
        "class_description": "<string>",
        "quantity": 123,
        "unit_nominal_value": 123,
        "currency": "<string>",
        "total_nominal_value": 123,
        "voting_rights": "<string>"
      }
    ],
    "contact": {
      "email": "<string>",
      "phone": "<string>",
      "fax": "<string>",
      "website": "<string>"
    },
    "identifiers": {
      "tax_id": "<string>",
      "secondary_registration_number": "<string>",
      "other_identifiers": [
        "<string>"
      ]
    },
    "activities": [
      {
        "code": "<string>",
        "description": "<string>"
      }
    ],
    "registered_agent": {
      "name": "<string>",
      "address": "<string>"
    }
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Body

application/json

string<uuid>

required

Unique identifier for the international business search.

state

enum<string>

required

The current state of the search.

Available options:

PENDING,

EXECUTING,

COMPLETED,

FAILED,

CANCELLED

created_at

string<date-time>

required

The datetime the search was created.

Example:

"2026-08-31T10:31:07.837093"

url

string<uri>

required

The API URL to retrieve the search.

Required string length: 1 - 2083

Example:

"https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314"

__event__

WebhookMetadata · object

Show child attributes

user

UserAttributionResponse (v1) · object | null

Details on the User who performed the search.

Show child attributes

name

string | null

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

Example:

"Acme Corporation"

address

string | null

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

Example:

"1640 Riverside Drive, Hill Valley, CA"

iso2_country_code

enum<string> | null

The ISO 2 country code the search ran against.

Available options:

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

Example:

"GB"

search_address

InternationalAddressSummaryResponse (v1) · object | null

The sanitized address inputted in the search.

Show child attributes

filing_number

string | null

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

Example:

"09517735"

reference_id

string | null

The reference ID inputted in the search.

Example:

"Search1234"

business_name_match

enum<string> | null

Indicates how close the inputted name matches the found business entity.

Available options:

NO_MATCH,

SIMILAR,

EXACT

Example:

"EXACT"

business_address_match

enum<string> | null

Indicates how close the inputted address matches the found business entity.

Available options:

NO_MATCH,

REGION,

CITY,

COUNTRY,

EXACT

Example:

"EXACT"

filing_number_match

boolean | null

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.

Example:

true

updated_at

string<date-time> | null

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

Example:

"2026-08-31T10:31:07.837103"

verified

boolean | null

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

Example:

true

scores

ScoreResponse (v1) · object[] | null

An array containing Baselayer's ratings.

Show child attributes

error

string | null

Any errors that occurred.

warnings

string[]

Any warnings that occurred.

Example:

"Address validation is unavailable."

options

enum<string>[]

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

Available options:

Order.Enhanced

Example:

["Order.Enhanced"]

business

InternationalBusinessResponse (v1) · object | null

A summary of the found business. When the enhanced profile add-on is ordered, this also includes officers, beneficial owners, shareholders, share capital, contact details, and the registered agent, along with fuller registry and tax identifiers and classified business activities.

Show child attributes

Response

Successful Response

Webhook Management

Webhook Events

International business search submitted

Body

Response