Post International Search
curl --request POST \
--url https://api.baselayer.com/international/searches \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data @- <<EOF
{
"iso2_country_code": "GB",
"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"
]
}
EOFimport requests
url = "https://api.baselayer.com/international/searches"
payload = {
"iso2_country_code": "GB",
"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"]
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
iso2_country_code: 'GB',
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']
})
};
fetch('https://api.baselayer.com/international/searches', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.baselayer.com/international/searches",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'iso2_country_code' => 'GB',
'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'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.baselayer.com/international/searches"
payload := strings.NewReader("{\n \"iso2_country_code\": \"GB\",\n \"name\": \"White, Floyd and Cook\",\n \"address\": \"1 Parliament St, London SW1A 2JR, United Kingdom\",\n \"filing_number\": \"09517735\",\n \"officer_names\": [\n \"Nathan Harrington\",\n \"Alexander Wolfe\"\n ],\n \"website\": \"https://www.figueroa.com/\",\n \"phone_number\": \"436-502-9710\",\n \"email\": \"zacharymoore@example.com\",\n \"alternative_names\": [\n \"Joe's Pizza\",\n \"Joe's Pizzeria\"\n ],\n \"reference_id\": \"Search1234\",\n \"options\": [\n \"Order.Enhanced\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.baselayer.com/international/searches")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"iso2_country_code\": \"GB\",\n \"name\": \"White, Floyd and Cook\",\n \"address\": \"1 Parliament St, London SW1A 2JR, United Kingdom\",\n \"filing_number\": \"09517735\",\n \"officer_names\": [\n \"Nathan Harrington\",\n \"Alexander Wolfe\"\n ],\n \"website\": \"https://www.figueroa.com/\",\n \"phone_number\": \"436-502-9710\",\n \"email\": \"zacharymoore@example.com\",\n \"alternative_names\": [\n \"Joe's Pizza\",\n \"Joe's Pizzeria\"\n ],\n \"reference_id\": \"Search1234\",\n \"options\": [\n \"Order.Enhanced\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/international/searches")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"iso2_country_code\": \"GB\",\n \"name\": \"White, Floyd and Cook\",\n \"address\": \"1 Parliament St, London SW1A 2JR, United Kingdom\",\n \"filing_number\": \"09517735\",\n \"officer_names\": [\n \"Nathan Harrington\",\n \"Alexander Wolfe\"\n ],\n \"website\": \"https://www.figueroa.com/\",\n \"phone_number\": \"436-502-9710\",\n \"email\": \"zacharymoore@example.com\",\n \"alternative_names\": [\n \"Joe's Pizza\",\n \"Joe's Pizzeria\"\n ],\n \"reference_id\": \"Search1234\",\n \"options\": [\n \"Order.Enhanced\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "PENDING",
"created_at": "2026-10-29T05:44:48.205317",
"url": "https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314",
"country_name": "United Kingdom",
"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",
"full_address": "<string>",
"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-29T05:44:48.205334",
"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>",
"entity_type": "Business",
"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>",
"entity_type": "Business",
"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>",
"entity_type": "Business",
"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 KYB
Post International Search
Create a new international business search.
POST
/
international
/
searches
Post International Search
curl --request POST \
--url https://api.baselayer.com/international/searches \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data @- <<EOF
{
"iso2_country_code": "GB",
"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"
]
}
EOFimport requests
url = "https://api.baselayer.com/international/searches"
payload = {
"iso2_country_code": "GB",
"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"]
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
iso2_country_code: 'GB',
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']
})
};
fetch('https://api.baselayer.com/international/searches', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.baselayer.com/international/searches",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'iso2_country_code' => 'GB',
'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'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.baselayer.com/international/searches"
payload := strings.NewReader("{\n \"iso2_country_code\": \"GB\",\n \"name\": \"White, Floyd and Cook\",\n \"address\": \"1 Parliament St, London SW1A 2JR, United Kingdom\",\n \"filing_number\": \"09517735\",\n \"officer_names\": [\n \"Nathan Harrington\",\n \"Alexander Wolfe\"\n ],\n \"website\": \"https://www.figueroa.com/\",\n \"phone_number\": \"436-502-9710\",\n \"email\": \"zacharymoore@example.com\",\n \"alternative_names\": [\n \"Joe's Pizza\",\n \"Joe's Pizzeria\"\n ],\n \"reference_id\": \"Search1234\",\n \"options\": [\n \"Order.Enhanced\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.baselayer.com/international/searches")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"iso2_country_code\": \"GB\",\n \"name\": \"White, Floyd and Cook\",\n \"address\": \"1 Parliament St, London SW1A 2JR, United Kingdom\",\n \"filing_number\": \"09517735\",\n \"officer_names\": [\n \"Nathan Harrington\",\n \"Alexander Wolfe\"\n ],\n \"website\": \"https://www.figueroa.com/\",\n \"phone_number\": \"436-502-9710\",\n \"email\": \"zacharymoore@example.com\",\n \"alternative_names\": [\n \"Joe's Pizza\",\n \"Joe's Pizzeria\"\n ],\n \"reference_id\": \"Search1234\",\n \"options\": [\n \"Order.Enhanced\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/international/searches")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"iso2_country_code\": \"GB\",\n \"name\": \"White, Floyd and Cook\",\n \"address\": \"1 Parliament St, London SW1A 2JR, United Kingdom\",\n \"filing_number\": \"09517735\",\n \"officer_names\": [\n \"Nathan Harrington\",\n \"Alexander Wolfe\"\n ],\n \"website\": \"https://www.figueroa.com/\",\n \"phone_number\": \"436-502-9710\",\n \"email\": \"zacharymoore@example.com\",\n \"alternative_names\": [\n \"Joe's Pizza\",\n \"Joe's Pizzeria\"\n ],\n \"reference_id\": \"Search1234\",\n \"options\": [\n \"Order.Enhanced\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "PENDING",
"created_at": "2026-10-29T05:44:48.205317",
"url": "https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314",
"country_name": "United Kingdom",
"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",
"full_address": "<string>",
"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-29T05:44:48.205334",
"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>",
"entity_type": "Business",
"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>",
"entity_type": "Business",
"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>",
"entity_type": "Business",
"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": {}
}
]
}Authorizations
Headers
An opaque key, ideally a UUID, that makes this request safe to retry. A second request with the same key, path, query and body answers with the resource the first one created, marked Idempotent-Replayed: true, instead of creating another; a sync request that finds it still running waits for it. The same key with a different request is refused with 422. Keys are scoped to your application and to this resource type, and are kept for the life of the resource.
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"
Body
application/json
Represents an international business search request.
The ISO 2 country code of the business to search for.
Available options:
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, IE, IM, IL, IT, JP, LV, LI, LT, LU, MY, MH, MQ, YT, ME, NL, NC, NZ, NO, OM, PK, PA, PE, PL, PT, QA, RE, RO, RU, BL, PM, WS, SG, SK, SI, SB, ES, SE, CH, TW, TT, UG, GB, UY, VI, VU, WF Example:
"GB"
The name of the business to search for. Required (together with address) unless filing_number is provided.
Required string length:
1 - 500Example:
"White, Floyd and Cook"
The address of the business to search for. Required (together with name) unless filing_number is provided.
Required string length:
2 - 500Example:
"1 Parliament St, London SW1A 2JR, United Kingdom"
The company registration (filing) number at the country's registry. 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 and address may each be supplied independently. Provided inputs contribute to KYB/Risk scores; omitted name or address inputs are excluded from matching and scoring.
Required string length:
1 - 128Example:
"09517735"
The officer names to include in the search.
Example:
["Nathan Harrington", "Alexander Wolfe"]
The website to include in the search.
Example:
"https://www.figueroa.com/"
The phone number to include in the search.
Example:
"436-502-9710"
The email to include in the search.
Example:
"zacharymoore@example.com"
The alternative names to include in the search.
Example:
["Joe's Pizza", "Joe's Pizzeria"]
An optional reference ID to associate with the search request.
Maximum string length:
128Example:
"Search1234"
Optional, separately-billed add-ons to enable for this search.
Available options:
Order.Pep, Order.Enhanced Example:
["Order.Enhanced"]
Response
Response
Response model for international business search.
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-29T05:44:48.205317"
The API URL to retrieve the search.
Required string length:
1 - 2083Example:
"https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314"
The display name of iso2_country_code, as GET /international/countries names it.
Example:
"United Kingdom"
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-29T05:44:48.205334"
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