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-08-31T10:31:07.837093",
"url": "https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314",
"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",
"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-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>",
"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-08-31T10:31:07.837093",
"url": "https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314",
"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",
"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-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>",
"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
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:
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"
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 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.
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.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-08-31T10:31:07.837093"
The API URL to retrieve the search.
Required string length:
1 - 2083Example:
"https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314"
Details on the User who performed the search.
Show child attributes
Show child attributes
The name inputted in the search (null for filing-number-only searches).
Example:
"Acme Corporation"
The address string inputted in the search (null for filing-number-only searches).
Example:
"1640 Riverside Drive, Hill Valley, CA"
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"
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.
Available options:
NO_MATCH, SIMILAR, EXACT Example:
"EXACT"
Indicates how close the inputted address matches the found business entity.
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.
Example:
true
The datetime the search was updated at (generally when the search completed).
Example:
"2026-08-31T10:31:07.837103"
Indicates whether the found business was a close enough match to be considered verified.
Example:
true
An array containing Baselayer's ratings.
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.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