curl --request GET \
--url https://api.baselayer.com/international/searches/{id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.baselayer.com/international/searches/{id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.baselayer.com/international/searches/{id}', 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/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.baselayer.com/international/searches/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.baselayer.com/international/searches/{id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/international/searches/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
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": {}
}
]
}Get International Search
Retrieve an international business search by ID.
curl --request GET \
--url https://api.baselayer.com/international/searches/{id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.baselayer.com/international/searches/{id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.baselayer.com/international/searches/{id}', 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/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.baselayer.com/international/searches/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.baselayer.com/international/searches/{id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/international/searches/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
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
Path Parameters
The unique identifier of the international search to retrieve.
"412a49b5-7466-426b-bf1e-081b00b54576"
"9d5a286e-a6d6-4d6c-a38e-8b7ea50accd5"
Response
Successful Response
Response model for international business search.
Unique identifier for the international business search.
The current state of the search.
PENDING, EXECUTING, COMPLETED, FAILED, CANCELLED The datetime the search was created.
"2026-08-31T10:31:07.837093"
The API URL to retrieve the search.
1 - 2083"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).
"Acme Corporation"
The address string inputted in the search (null for filing-number-only searches).
"1640 Riverside Drive, Hill Valley, CA"
The ISO 2 country code the search ran against.
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 "GB"
The sanitized address inputted in the search.
Show child attributes
Show child attributes
The company registration (filing) number inputted in the search.
"09517735"
The reference ID inputted in the search.
"Search1234"
Indicates how close the inputted name matches the found business entity.
NO_MATCH, SIMILAR, EXACT "EXACT"
Indicates how close the inputted address matches the found business entity.
NO_MATCH, REGION, CITY, COUNTRY, EXACT "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.
true
The datetime the search was updated at (generally when the search completed).
"2026-08-31T10:31:07.837103"
Indicates whether the found business was a close enough match to be considered verified.
true
An array containing Baselayer's ratings.
Show child attributes
Show child attributes
Any errors that occurred.
Any warnings that occurred.
"Address validation is unavailable."
Optional, separately-billed add-ons requested for this search.
Order.Enhanced ["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