{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2026-10-22T15:43:38.207879",
"url": "https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314",
"__event__": {
"type": "InternationalBusinessSearch.completed",
"origin": "api"
},
"user": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"first_name": "Austin",
"last_name": "Taylor",
"email": "jessicasimpson@example.com"
},
"idempotency_key": "<string>",
"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-10-22T15:43:38.207895",
"verified": true,
"scores": [
{
"type": "risk",
"score": 95,
"rating": "A"
}
],
"watchlist_hits": [
{
"code": "DMF",
"name": "Death Master File",
"count": 1,
"details": [
{
"address": "123 Main St",
"date_of_birth": "1980-01-01",
"name": "John Doe"
}
]
}
],
"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": {}
}
]
}International
International business search completed
Emitted when an International Business search has completed and results are available.
WEBHOOK
InternationalBusinessSearch.completed
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2026-10-22T15:43:38.207879",
"url": "https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314",
"__event__": {
"type": "InternationalBusinessSearch.completed",
"origin": "api"
},
"user": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"first_name": "Austin",
"last_name": "Taylor",
"email": "jessicasimpson@example.com"
},
"idempotency_key": "<string>",
"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-10-22T15:43:38.207895",
"verified": true,
"scores": [
{
"type": "risk",
"score": 95,
"rating": "A"
}
],
"watchlist_hits": [
{
"code": "DMF",
"name": "Death Master File",
"count": 1,
"details": [
{
"address": "123 Main St",
"date_of_birth": "1980-01-01",
"name": "John Doe"
}
]
}
],
"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
Unique identifier for the international business search.
The current state of the search.
Available options:
PENDING, EXECUTING, COMPLETED, FAILED, CANCELLED The datetime the search was created.
Example:
"2026-10-22T15:43:38.207879"
The API URL to retrieve the search.
Required string length:
1 - 2083Example:
"https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314"
Show child attributes
Show child attributes
Details on the User who performed the search.
Show child attributes
Show child attributes
The Idempotency-Key header the request that created this resource carried, if any.
The name inputted in the search (null when omitted).
Example:
"Acme Corporation"
The address string inputted in the search (null when omitted).
Example:
"1640 Riverside Drive, Hill Valley, CA"
The ISO 2 country code the search ran against.
Available options:
AR, AU, AT, BH, BE, BA, BR, BN, KH, CA, CN, CO, HR, CW, CY, CZ, DK, DO, EE, FI, FR, GF, PF, GE, DE, GI, GR, GP, GG, HK, IS, IN, IE, IM, IL, IT, JP, KE, LV, LI, LT, LU, MY, MH, MQ, YT, MX, ME, NL, NC, NZ, NG, NO, OM, PK, PA, PE, PL, PT, QA, RE, RO, RU, BL, PM, WS, SA, SG, SK, SI, SB, ES, SE, CH, TW, TT, TR, UG, UA, GB, UY, VI, VU, WF Example:
"GB"
The sanitized address inputted in the search.
Show child attributes
Show child attributes
The company registration (filing) number inputted in the search.
Example:
"09517735"
The reference ID inputted in the search.
Example:
"Search1234"
Indicates how close the inputted name matches the found business entity. Null when this input was omitted.
Available options:
NO_MATCH, SIMILAR, EXACT Example:
"EXACT"
Indicates how close the inputted address matches the found business entity. Null when this input was omitted.
Available options:
NO_MATCH, REGION, CITY, COUNTRY, EXACT Example:
"EXACT"
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 or the lookup was unavailable.
Example:
true
The datetime the search was updated at (generally when the search completed).
Example:
"2026-10-22T15:43:38.207895"
True when the KYB grade is A or B. A filing-number mismatch reduces the score but does not independently block verification.
Example:
true
An array containing Baselayer's ratings.
Show child attributes
Show child attributes
Persisted watchlist screening results for this search. A source with count zero completed screening without matches. An absent source does not indicate a completed or clean screen.
Show child attributes
Show child attributes
Any errors that occurred.
Any warnings that occurred.
Example:
"Address validation is unavailable."
Optional, separately-billed add-ons requested for this search.
Available options:
Order.Pep, Order.Enhanced Example:
["Order.Enhanced"]
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
Show child attributes
Response
Successful Response