Post Search
curl --request POST \
--url https://api.baselayer.com/searches \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data @- <<EOF
{
"name": "White, Floyd and Cook",
"address": "155 Carla Circles Jordanfurt, OK 59066",
"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"
],
"tin": "732842774",
"options": [
"Order.WebsiteAnalysis"
],
"reference_id": "Search1234"
}
EOFimport requests
url = "https://api.baselayer.com/searches"
payload = {
"name": "White, Floyd and Cook",
"address": "155 Carla Circles Jordanfurt, OK 59066",
"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"],
"tin": "732842774",
"options": ["Order.WebsiteAnalysis"],
"reference_id": "Search1234"
}
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({
name: 'White, Floyd and Cook',
address: '155 Carla Circles Jordanfurt, OK 59066',
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'],
tin: '732842774',
options: ['Order.WebsiteAnalysis'],
reference_id: 'Search1234'
})
};
fetch('https://api.baselayer.com/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/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([
'name' => 'White, Floyd and Cook',
'address' => '155 Carla Circles Jordanfurt, OK 59066',
'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'
],
'tin' => '732842774',
'options' => [
'Order.WebsiteAnalysis'
],
'reference_id' => 'Search1234'
]),
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/searches"
payload := strings.NewReader("{\n \"name\": \"White, Floyd and Cook\",\n \"address\": \"155 Carla Circles Jordanfurt, OK 59066\",\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 \"tin\": \"732842774\",\n \"options\": [\n \"Order.WebsiteAnalysis\"\n ],\n \"reference_id\": \"Search1234\"\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/searches")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"White, Floyd and Cook\",\n \"address\": \"155 Carla Circles Jordanfurt, OK 59066\",\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 \"tin\": \"732842774\",\n \"options\": [\n \"Order.WebsiteAnalysis\"\n ],\n \"reference_id\": \"Search1234\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/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 \"name\": \"White, Floyd and Cook\",\n \"address\": \"155 Carla Circles Jordanfurt, OK 59066\",\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 \"tin\": \"732842774\",\n \"options\": [\n \"Order.WebsiteAnalysis\"\n ],\n \"reference_id\": \"Search1234\"\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"options": [
"Order.WebsiteAnalysis"
],
"state": "PENDING",
"name": "Acme Corporation",
"address": "1640 Riverside Drive, Hill Valley, CA",
"created_at": "2026-08-31T10:31:07.796090",
"url": "https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314",
"status_url": "https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314/status",
"business_url": "https://api.baselayer.com/businesses/febe48f6-1f57-11ef-8bbf-1edb1b067314/status",
"orderables": [
{
"id": "10a87552-c8a4-4d33-a8dc-1f734d80a9ba",
"option": "Order.WebsiteAnalysis",
"type": "WebsiteAnalysisRequest",
"url": "https://api.baselayer.com/website_analysis_requests/10a87552-c8a4-4d33-a8dc-1f734d80a9ba"
}
],
"user": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"first_name": "Austin",
"last_name": "Taylor",
"email": "jessicasimpson@example.com"
},
"search_address": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"street": "913 Hendrix Gardens Suite 492",
"city": "Jasonfurt",
"state": "VA",
"zip": "19773",
"latitude": 38.03012,
"longitude": 78.47665,
"rdi": "Commercial",
"deliverable": false,
"cmra": false,
"url": "<string>",
"delivery_type": "STREET"
},
"officer_names": [
"Doc Brown"
],
"alternative_names": [
"Joe's Pizza",
"Joe's Pizzeria"
],
"website": "https://baselayer.com/",
"phone_number": "636-555-3226",
"email": "support@baselayer.com",
"tin": "555666777",
"reference_id": "Search1234",
"tin_matched": true,
"tin_match_type": "SSN",
"tin_potential_match": "Baselayer",
"watchlist_hits": [],
"business_name_match": "EXACT",
"business_address_match": "EXACT",
"business_officer_match": "SIMILAR",
"registered_agent_match": "SIMILAR",
"business_website_match": true,
"business_website_redirect_match": true,
"search_address_validation_level": "FULL",
"updated_at": "2026-08-31T10:31:07.796101",
"verified": true,
"scores": [
{
"type": "risk",
"score": 95,
"rating": "A"
}
],
"error": "<string>",
"warnings": [
"IRS Validation is unavailable."
],
"business": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Levine-Santos",
"url": "https://api.baselayer.com/businesses/9083e7e2-1f6b-11ef-8f0f-1edb1b067314",
"console_url": "https://console.baselayer.com/business/9083e7e2-1f6b-11ef-8f0f-1edb1b067314",
"address": "63788 Paige Lane Cooperfurt, MI 10037",
"structure": "C_CORPORATION",
"addresses": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"street": "913 Hendrix Gardens Suite 492",
"city": "Jasonfurt",
"state": "VA",
"zip": "19773",
"latitude": 38.03012,
"longitude": 78.47665,
"rdi": "Commercial",
"deliverable": false,
"cmra": false,
"url": "<string>",
"delivery_type": "STREET",
"sources": [
"SOS",
"Online"
]
}
],
"phone_numbers": [
"251-829-8026"
],
"email": "kathleenholmes@example.com",
"website": "http://www.cruz-adkins.net/",
"social_profiles": {
"confidence": null,
"found_on": [],
"metadata": null,
"site": "twitter",
"url": "https://twitter.com/michelle98",
"username": "michelle98"
},
"reviews": [
{
"url": "https://www.yelp.com/biz/certified-power-inc-mundelein",
"source": "yelp",
"confidence": "high",
"rating": 4.5,
"volume": 23,
"summary": "5 reviews mention that the service was great and the owner was very helpful.",
"phone_number": "+12125551234",
"address": "123 Main St, Anytown, USA",
"business_website": "https://www.example.com",
"reviews": [
{
"username": "John Doe",
"text": "This is a great review!",
"date": "2024-01-01",
"rating": 5
}
],
"metadata": {
"open_state": "Open",
"operating_hours": {},
"description": "<string>",
"types": [
"Restaurant",
"Italian restaurant"
],
"service_options": {}
}
}
],
"directory_listings": [
{
"source": "bbb.org",
"url": "https://www.bbb.org/us/ca/modesto/profile/plumber/joes-plumbing-1234",
"category": "Plumbing Contractor",
"business_name": "Joe's Plumbing & Heating",
"phone_number": "<string>",
"email": "<string>",
"business_website": "<string>",
"address": "<string>",
"people": [
{
"name": "<string>",
"title": "<string>"
}
]
}
],
"ein": "871888915",
"incorporation_state": "HI",
"incorporation_date": "2011-11-27",
"months_in_business": 256,
"primary_address": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"street": "913 Hendrix Gardens Suite 492",
"city": "Jasonfurt",
"state": "VA",
"zip": "19773",
"latitude": 38.03012,
"longitude": 78.47665,
"rdi": "Commercial",
"deliverable": false,
"cmra": false,
"url": "<string>",
"delivery_type": "STREET"
},
"alternative_names": [
"Ramos, Garcia and Good"
],
"registrations": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Garcia, Hernandez and Woods",
"file_number": "867124",
"state": "AZ",
"status": "active",
"issue_date": "2024-01-01",
"inactive_date": "2024-06-01",
"dissolution_date": "2024-06-01",
"address": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"street": "913 Hendrix Gardens Suite 492",
"city": "Jasonfurt",
"state": "VA",
"zip": "19773",
"latitude": 38.03012,
"longitude": 78.47665,
"rdi": "Commercial",
"deliverable": false,
"cmra": false,
"url": "<string>",
"delivery_type": "STREET"
},
"registration_type": "domestic",
"standing": "In Good Standing",
"registered_agent": {
"name": "Jeremy Crawford",
"address": {
"city": "Andrewton",
"cmra": false,
"deliverable": false,
"delivery_type": null,
"id": "ab237e72-7053-439d-ae5e-edbac59bf7cb",
"latitude": 34.0522,
"longitude": -118.2437,
"rdi": null,
"state": "CA",
"street": "3032 Mark Parks Andrewton, CA 27458",
"url": null,
"zip": "27458"
}
},
"officers": []
}
],
"business_officers": [
{
"name": "Philip Mcguire",
"titles": [
"CEO",
"Founder"
],
"states": [
"CA",
"NY"
],
"sources": [
"SOS",
"Online"
]
}
],
"predicted_naics": [],
"watchlist_hits": [],
"sec_registrations": [],
"revenue": null,
"phone_number": "955-714-3269"
},
"console_url": "https://console.baselayer.com/business/febe48f6-1f57-11ef-8bbf-1edb1b067314"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}KYB Search
Post Search
Create a new business search.
Supports both the legacy Accept: application/vnd.osiris.sync+json header
(v1 backward compatibility) and the new Prefer header (RFC 7240) for
controlling sync/async execution. When both are present, Prefer takes
precedence.
POST
/
searches
Post Search
curl --request POST \
--url https://api.baselayer.com/searches \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data @- <<EOF
{
"name": "White, Floyd and Cook",
"address": "155 Carla Circles Jordanfurt, OK 59066",
"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"
],
"tin": "732842774",
"options": [
"Order.WebsiteAnalysis"
],
"reference_id": "Search1234"
}
EOFimport requests
url = "https://api.baselayer.com/searches"
payload = {
"name": "White, Floyd and Cook",
"address": "155 Carla Circles Jordanfurt, OK 59066",
"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"],
"tin": "732842774",
"options": ["Order.WebsiteAnalysis"],
"reference_id": "Search1234"
}
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({
name: 'White, Floyd and Cook',
address: '155 Carla Circles Jordanfurt, OK 59066',
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'],
tin: '732842774',
options: ['Order.WebsiteAnalysis'],
reference_id: 'Search1234'
})
};
fetch('https://api.baselayer.com/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/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([
'name' => 'White, Floyd and Cook',
'address' => '155 Carla Circles Jordanfurt, OK 59066',
'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'
],
'tin' => '732842774',
'options' => [
'Order.WebsiteAnalysis'
],
'reference_id' => 'Search1234'
]),
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/searches"
payload := strings.NewReader("{\n \"name\": \"White, Floyd and Cook\",\n \"address\": \"155 Carla Circles Jordanfurt, OK 59066\",\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 \"tin\": \"732842774\",\n \"options\": [\n \"Order.WebsiteAnalysis\"\n ],\n \"reference_id\": \"Search1234\"\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/searches")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"White, Floyd and Cook\",\n \"address\": \"155 Carla Circles Jordanfurt, OK 59066\",\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 \"tin\": \"732842774\",\n \"options\": [\n \"Order.WebsiteAnalysis\"\n ],\n \"reference_id\": \"Search1234\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/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 \"name\": \"White, Floyd and Cook\",\n \"address\": \"155 Carla Circles Jordanfurt, OK 59066\",\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 \"tin\": \"732842774\",\n \"options\": [\n \"Order.WebsiteAnalysis\"\n ],\n \"reference_id\": \"Search1234\"\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"options": [
"Order.WebsiteAnalysis"
],
"state": "PENDING",
"name": "Acme Corporation",
"address": "1640 Riverside Drive, Hill Valley, CA",
"created_at": "2026-08-31T10:31:07.796090",
"url": "https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314",
"status_url": "https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314/status",
"business_url": "https://api.baselayer.com/businesses/febe48f6-1f57-11ef-8bbf-1edb1b067314/status",
"orderables": [
{
"id": "10a87552-c8a4-4d33-a8dc-1f734d80a9ba",
"option": "Order.WebsiteAnalysis",
"type": "WebsiteAnalysisRequest",
"url": "https://api.baselayer.com/website_analysis_requests/10a87552-c8a4-4d33-a8dc-1f734d80a9ba"
}
],
"user": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"first_name": "Austin",
"last_name": "Taylor",
"email": "jessicasimpson@example.com"
},
"search_address": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"street": "913 Hendrix Gardens Suite 492",
"city": "Jasonfurt",
"state": "VA",
"zip": "19773",
"latitude": 38.03012,
"longitude": 78.47665,
"rdi": "Commercial",
"deliverable": false,
"cmra": false,
"url": "<string>",
"delivery_type": "STREET"
},
"officer_names": [
"Doc Brown"
],
"alternative_names": [
"Joe's Pizza",
"Joe's Pizzeria"
],
"website": "https://baselayer.com/",
"phone_number": "636-555-3226",
"email": "support@baselayer.com",
"tin": "555666777",
"reference_id": "Search1234",
"tin_matched": true,
"tin_match_type": "SSN",
"tin_potential_match": "Baselayer",
"watchlist_hits": [],
"business_name_match": "EXACT",
"business_address_match": "EXACT",
"business_officer_match": "SIMILAR",
"registered_agent_match": "SIMILAR",
"business_website_match": true,
"business_website_redirect_match": true,
"search_address_validation_level": "FULL",
"updated_at": "2026-08-31T10:31:07.796101",
"verified": true,
"scores": [
{
"type": "risk",
"score": 95,
"rating": "A"
}
],
"error": "<string>",
"warnings": [
"IRS Validation is unavailable."
],
"business": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Levine-Santos",
"url": "https://api.baselayer.com/businesses/9083e7e2-1f6b-11ef-8f0f-1edb1b067314",
"console_url": "https://console.baselayer.com/business/9083e7e2-1f6b-11ef-8f0f-1edb1b067314",
"address": "63788 Paige Lane Cooperfurt, MI 10037",
"structure": "C_CORPORATION",
"addresses": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"street": "913 Hendrix Gardens Suite 492",
"city": "Jasonfurt",
"state": "VA",
"zip": "19773",
"latitude": 38.03012,
"longitude": 78.47665,
"rdi": "Commercial",
"deliverable": false,
"cmra": false,
"url": "<string>",
"delivery_type": "STREET",
"sources": [
"SOS",
"Online"
]
}
],
"phone_numbers": [
"251-829-8026"
],
"email": "kathleenholmes@example.com",
"website": "http://www.cruz-adkins.net/",
"social_profiles": {
"confidence": null,
"found_on": [],
"metadata": null,
"site": "twitter",
"url": "https://twitter.com/michelle98",
"username": "michelle98"
},
"reviews": [
{
"url": "https://www.yelp.com/biz/certified-power-inc-mundelein",
"source": "yelp",
"confidence": "high",
"rating": 4.5,
"volume": 23,
"summary": "5 reviews mention that the service was great and the owner was very helpful.",
"phone_number": "+12125551234",
"address": "123 Main St, Anytown, USA",
"business_website": "https://www.example.com",
"reviews": [
{
"username": "John Doe",
"text": "This is a great review!",
"date": "2024-01-01",
"rating": 5
}
],
"metadata": {
"open_state": "Open",
"operating_hours": {},
"description": "<string>",
"types": [
"Restaurant",
"Italian restaurant"
],
"service_options": {}
}
}
],
"directory_listings": [
{
"source": "bbb.org",
"url": "https://www.bbb.org/us/ca/modesto/profile/plumber/joes-plumbing-1234",
"category": "Plumbing Contractor",
"business_name": "Joe's Plumbing & Heating",
"phone_number": "<string>",
"email": "<string>",
"business_website": "<string>",
"address": "<string>",
"people": [
{
"name": "<string>",
"title": "<string>"
}
]
}
],
"ein": "871888915",
"incorporation_state": "HI",
"incorporation_date": "2011-11-27",
"months_in_business": 256,
"primary_address": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"street": "913 Hendrix Gardens Suite 492",
"city": "Jasonfurt",
"state": "VA",
"zip": "19773",
"latitude": 38.03012,
"longitude": 78.47665,
"rdi": "Commercial",
"deliverable": false,
"cmra": false,
"url": "<string>",
"delivery_type": "STREET"
},
"alternative_names": [
"Ramos, Garcia and Good"
],
"registrations": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Garcia, Hernandez and Woods",
"file_number": "867124",
"state": "AZ",
"status": "active",
"issue_date": "2024-01-01",
"inactive_date": "2024-06-01",
"dissolution_date": "2024-06-01",
"address": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"street": "913 Hendrix Gardens Suite 492",
"city": "Jasonfurt",
"state": "VA",
"zip": "19773",
"latitude": 38.03012,
"longitude": 78.47665,
"rdi": "Commercial",
"deliverable": false,
"cmra": false,
"url": "<string>",
"delivery_type": "STREET"
},
"registration_type": "domestic",
"standing": "In Good Standing",
"registered_agent": {
"name": "Jeremy Crawford",
"address": {
"city": "Andrewton",
"cmra": false,
"deliverable": false,
"delivery_type": null,
"id": "ab237e72-7053-439d-ae5e-edbac59bf7cb",
"latitude": 34.0522,
"longitude": -118.2437,
"rdi": null,
"state": "CA",
"street": "3032 Mark Parks Andrewton, CA 27458",
"url": null,
"zip": "27458"
}
},
"officers": []
}
],
"business_officers": [
{
"name": "Philip Mcguire",
"titles": [
"CEO",
"Founder"
],
"states": [
"CA",
"NY"
],
"sources": [
"SOS",
"Online"
]
}
],
"predicted_naics": [],
"watchlist_hits": [],
"sec_registrations": [],
"revenue": null,
"phone_number": "955-714-3269"
},
"console_url": "https://console.baselayer.com/business/febe48f6-1f57-11ef-8bbf-1edb1b067314"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
Headers
Request execution preference (RFC 7240). Use respond-async for asynchronous execution, or wait=N to specify a synchronous timeout hint in seconds. When present, takes precedence over the legacy Accept header sync flag.
The MIME type of the response to accept.
Example:
"application/json"
Body
application/json
Represents a business search request.
The name of the business to search for.
Required string length:
1 - 500Example:
"White, Floyd and Cook"
The address of the business to search for.
Required string length:
2 - 500Example:
"155 Carla Circles Jordanfurt, OK 59066"
The officer names to include in the search.
Example:
["Nathan Harrington", "Alexander Wolfe"]
The website to include in the search.
Minimum string length:
1Example:
"https://www.figueroa.com/"
The phone number to include in the search.
Maximum string length:
24Example:
"436-502-9710"
The email to include in the search.
Maximum string length:
64Example:
"zacharymoore@example.com"
The alternative names to include in the search.
Example:
["Joe's Pizza", "Joe's Pizzeria"]
The TIN/EIN to search for.
Required string length:
9Example:
"732842774"
Optional features to enable during search execution.
Available options:
Order.WebsiteAnalysis, Order.NaicsPrediction, Order.Pep, Order.Enhanced Example:
["Order.WebsiteAnalysis"]
An optional reference ID to associate with the search request.
Maximum string length:
128Example:
"Search1234"
Response
Response
The unique identifier of the search.
Optional features enabled during search execution.
Available options:
Order.WebsiteAnalysis, Order.NaicsPrediction, Order.Pep, Order.Enhanced Example:
["Order.WebsiteAnalysis"]
The current state of the search.
Available options:
PENDING, EXECUTING, COMPLETED, FAILED, CANCELLED The name inputted in the search.
Example:
"Acme Corporation"
The address string inputted in the search.
Example:
"1640 Riverside Drive, Hill Valley, CA"
The datetime the search was created.
Example:
"2026-08-31T10:31:07.796090"
The API URL to retrieve the search.
Required string length:
1 - 2083Example:
"https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314"
The API URL to retrieve the status of the search.
Required string length:
1 - 2083Example:
"https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314/status"
The API URL to retrieve the business details.
Required string length:
1 - 2083Example:
"https://api.baselayer.com/businesses/febe48f6-1f57-11ef-8bbf-1edb1b067314/status"
A list of associated requests that were made as a result of ordering optional features through the options when the search was submitted. This allows you to correlate associated operations that will complete asynchronously once the search is completed. For example, if you order Website Analysis when issuing the search you will have a corresponding WebsiteAnalysisRequest orderable containing the ID and URL of the forthcoming associated operations.
Show child attributes
Show child attributes
Example:
[ { "id": "10a87552-c8a4-4d33-a8dc-1f734d80a9ba", "option": "Order.WebsiteAnalysis", "type": "WebsiteAnalysisRequest", "url": "https://api.baselayer.com/website_analysis_requests/10a87552-c8a4-4d33-a8dc-1f734d80a9ba" } ]
Details on the User who performed the search.
Show child attributes
Show child attributes
The sanitized address inputted in the search.
Show child attributes
Show child attributes
The officer names inputted in the search.
Example:
["Doc Brown"]
The alternative names inputted in the search.
Example:
["Joe's Pizza", "Joe's Pizzeria"]
The website inputted in the search.
Example:
"https://baselayer.com/"
The phone number inputted in the search.
Example:
"636-555-3226"
The email inputted in the search.
Example:
"support@baselayer.com"
The TIN/EIN inputted in the search.
Example:
"555666777"
The reference ID inputted in the search.
Example:
"Search1234"
Indicates whether the inputted TIN/EIN was a match, per the IRS. If a TIN is submitted with the search, and a response of null is returned, this indicates that the IRS validation service is currently having a temporary outage. Please see status.baselayer.com for status updates.
Example:
true
The type of match that occurred.
Available options:
SSN, EIN, UNKNOWN Example:
"SSN"
If the inputted TIN/EIN was not a match, but is a real TIN/EIN, this field returns the name of the entity to whom that TIN/EIN actually belongs.
Example:
"Baselayer"
The watchlist hits associated with the searched business.
Show child attributes
Show child attributes
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, CITY, STATE, SIMILAR, EXACT Example:
"EXACT"
Indicates how close the inputted officer name matches the found business officers.
Available options:
NO_MATCH, SIMILAR, EXACT Example:
"SIMILAR"
Indicates how close the inputted officer name matches the found business registered agent.
Available options:
NO_MATCH, SIMILAR, EXACT Example:
"SIMILAR"
Does the inputted website match the found business website?
Example:
true
Indicates whether the website match was established via a cross-domain redirect. True when business_website_match is True and the match was found because one website redirects to the other's domain.
Example:
true
The validation level derived during address normalization.
Available options:
FULL, PARTIAL, INVALID Example:
"FULL"
The datetime the search was updated at (generally when the search completed).
Example:
"2026-08-31T10:31:07.796101"
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:
["IRS Validation is unavailable."]
A representation of the Business identified by the Search.
Show child attributes
Show child attributes
The URL to the search details in the console.
Required string length:
1 - 2083Example:
"https://console.baselayer.com/business/febe48f6-1f57-11ef-8bbf-1edb1b067314"