Post Search

curl --request POST \
  --url https://api.baselayer.com/searches \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "name": "White, Floyd and Cook",
  "address": "155 Carla Circles Jordanfurt, OK 59066",
  "options": []
}
'

import requests

url = "https://api.baselayer.com/searches"

payload = {
    "name": "White, Floyd and Cook",
    "address": "155 Carla Circles Jordanfurt, OK 59066",
    "options": []
}
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',
    options: []
  })
};

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',
    'options' => [
        
    ]
  ]),
  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  \"options\": []\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  \"options\": []\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  \"options\": []\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-10-01T03:07:36.348906",
  "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": "f30f498c-6a24-448a-8dec-b59b9ad2ffff",
      "option": "Order.WebsiteAnalysis",
      "type": "WebsiteAnalysisRequest",
      "url": "https://api.baselayer.com/website_analysis_requests/f30f498c-6a24-448a-8dec-b59b9ad2ffff"
    }
  ],
  "user": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "first_name": "Austin",
    "last_name": "Taylor",
    "email": "jessicasimpson@example.com"
  },
  "idempotency_key": "<string>",
  "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-10-01T03:07:36.348922",
  "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": [
          "Online",
          "SOS"
        ]
      }
    ],
    "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": "4f5f3aae-41ab-4876-810f-74223df7913d",
            "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": [
          "Online",
          "SOS"
        ]
      }
    ],
    "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": {}
    }
  ]
}

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 '
{
  "name": "White, Floyd and Cook",
  "address": "155 Carla Circles Jordanfurt, OK 59066",
  "options": []
}
'

import requests

url = "https://api.baselayer.com/searches"

payload = {
    "name": "White, Floyd and Cook",
    "address": "155 Carla Circles Jordanfurt, OK 59066",
    "options": []
}
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',
    options: []
  })
};

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',
    'options' => [
        
    ]
  ]),
  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  \"options\": []\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  \"options\": []\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  \"options\": []\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-10-01T03:07:36.348906",
  "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": "f30f498c-6a24-448a-8dec-b59b9ad2ffff",
      "option": "Order.WebsiteAnalysis",
      "type": "WebsiteAnalysisRequest",
      "url": "https://api.baselayer.com/website_analysis_requests/f30f498c-6a24-448a-8dec-b59b9ad2ffff"
    }
  ],
  "user": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "first_name": "Austin",
    "last_name": "Taylor",
    "email": "jessicasimpson@example.com"
  },
  "idempotency_key": "<string>",
  "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-10-01T03:07:36.348922",
  "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": [
          "Online",
          "SOS"
        ]
      }
    ],
    "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": "4f5f3aae-41ab-4876-810f-74223df7913d",
            "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": [
          "Online",
          "SOS"
        ]
      }
    ],
    "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

X-API-Key

string

header

required

Headers

Prefer

string | null

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.

Idempotency-Key

string | null

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.

string | null

The MIME type of the response to accept.

Example:

"application/json"

Body

application/json

Name and address (v1)
Business token (v1)

Search for a business by its name and address.

Send the business's legal name and address, plus any optional details you hold. To search for a business an autocomplete suggestion names, send its business_token instead, in the business-token form.

name

string

required

The name of the business to search for.

Required string length: 1 - 500

Example:

"White, Floyd and Cook"

address

string

required

The address of the business to search for.

Required string length: 2 - 500

Example:

"155 Carla Circles Jordanfurt, OK 59066"

officer_names

string[] | null

The officer names to include in the search.

Example:

["Nathan Harrington", "Alexander Wolfe"]

website

string<uri> | null

The website to include in the search.

Minimum string length: 1

Example:

"https://www.figueroa.com/"

phone_number

string | null

The phone number to include in the search.

Maximum string length: 24

Example:

"436-502-9710"

string | null

The email to include in the search.

Maximum string length: 64

Example:

"zacharymoore@example.com"

alternative_names

string[] | null

The alternative names to include in the search.

Example:

["Joe's Pizza", "Joe's Pizzeria"]

tin

string | null

The TIN/EIN to search for.

Required string length: 9

Example:

"732842774"

options

enum<string>[]

Optional features to enable during search execution.

Available options:

Order.WebsiteAnalysis,

Order.NaicsPrediction,

Order.Pep,

Order.Enhanced

Example:

["Order.WebsiteAnalysis"]

reference_id

string | null

An optional reference ID to associate with the search request.

Maximum string length: 128

Example:

"Search1234"

business_token

null

Leave out; see the business-token form.

Response

string<uuid>

required

The unique identifier of the search.

options

enum<string>[]

required

Optional features enabled during search execution.

Available options:

Order.WebsiteAnalysis,

Order.NaicsPrediction,

Order.Pep,

Order.Enhanced

Example:

["Order.WebsiteAnalysis"]

state

enum<string>

required

The current state of the search.

Available options:

PENDING,

EXECUTING,

COMPLETED,

FAILED,

CANCELLED

name

string

required

The name inputted in the search.

Example:

"Acme Corporation"

address

string

required

The address string inputted in the search.

Example:

"1640 Riverside Drive, Hill Valley, CA"

created_at

string<date-time>

required

The datetime the search was created.

Example:

"2026-10-01T03:07:36.348906"

url

string<uri>

required

The API URL to retrieve the search.

Required string length: 1 - 2083

Example:

"https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314"

status_url

string<uri>

required

The API URL to retrieve the status of the search.

Required string length: 1 - 2083

Example:

"https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314/status"

business_url

string<uri> | null

required

The API URL to retrieve the business details.

Required string length: 1 - 2083

Example:

"https://api.baselayer.com/businesses/febe48f6-1f57-11ef-8bbf-1edb1b067314/status"

orderables

Orderable · object[]

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

Example:

[
  {
    "id": "f30f498c-6a24-448a-8dec-b59b9ad2ffff",
    "option": "Order.WebsiteAnalysis",
    "type": "WebsiteAnalysisRequest",
    "url": "https://api.baselayer.com/website_analysis_requests/f30f498c-6a24-448a-8dec-b59b9ad2ffff"
  }
]

user

UserAttributionResponse (v1) · object | null

Details on the User who performed the search.

Show child attributes

idempotency_key

string | null

The Idempotency-Key header the request that created this resource carried, if any.

search_address

AddressSummaryResponse (v1) · object | null

The sanitized address inputted in the search.

Show child attributes

officer_names

string[] | null

The officer names inputted in the search.

Example:

["Doc Brown"]

alternative_names

string[] | null

The alternative names inputted in the search.

Example:

["Joe's Pizza", "Joe's Pizzeria"]

website

string | null

The website inputted in the search.

Example:

"https://baselayer.com/"

phone_number

string | null

The phone number inputted in the search.

Example:

"636-555-3226"

string | null

The email inputted in the search.

Example:

"support@baselayer.com"

tin

string | null

The TIN/EIN inputted in the search.

Example:

"555666777"

reference_id

string | null

The reference ID inputted in the search.

Example:

"Search1234"

tin_matched

boolean | null

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

tin_match_type

enum<string> | null

The type of match that occurred.

Available options:

SSN,

EIN,

UNKNOWN

Example:

"SSN"

tin_potential_match

string | null

deprecated

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"

watchlist_hits

WatchlistHitResponse (v1) · object[]

The watchlist hits associated with the searched business.

Show child attributes

business_name_match

enum<string> | null

Indicates how close the inputted name matches the found business entity.

Available options:

NO_MATCH,

SIMILAR,

EXACT

Example:

"EXACT"

business_address_match

enum<string> | null

Indicates how close the inputted address matches the found business entity.

Available options:

NO_MATCH,

CITY,

STATE,

SIMILAR,

EXACT

Example:

"EXACT"

business_officer_match

enum<string> | null

Indicates how close the inputted officer name matches the found business officers.

Available options:

NO_MATCH,

SIMILAR,

EXACT

Example:

"SIMILAR"

registered_agent_match

enum<string> | null

Indicates how close the inputted officer name matches the found business registered agent.

Available options:

NO_MATCH,

SIMILAR,

EXACT

Example:

"SIMILAR"

business_website_match

boolean | null

Does the inputted website match the found business website?

Example:

true

business_website_redirect_match

boolean | null

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

search_address_validation_level

enum<string> | null

The validation level derived during address normalization.

Available options:

FULL,

PARTIAL,

INVALID

Example:

"FULL"

updated_at

string<date-time> | null

The datetime the search was updated at (generally when the search completed).

Example:

"2026-10-01T03:07:36.348922"

verified

boolean | null

Indicates whether the found business was a close enough match to be considered verified.

Example:

true

scores

ScoreResponse (v1) · object[] | null

An array containing Baselayer's ratings.

Show child attributes

error

string | null

Any errors that occurred.

warnings

string[]

Any warnings that occurred.

Example:

["IRS Validation is unavailable."]

business

BusinessResponse (v1) · object | null

A representation of the Business identified by the Search.

Show child attributes

console_url

string<uri>

The URL to the search details in the console.

Required string length: 1 - 2083

Example:

"https://console.baselayer.com/business/febe48f6-1f57-11ef-8bbf-1edb1b067314"

Business Verification

Liens

Litigations

Online

Portfolio Monitoring

Post Search

Authorizations

Headers

Body

Response