Skip to main content
GET
Get Searches

Authorizations

X-API-Key
string
header
required

Query Parameters

q
string | null

The query param, can either be a search name or a search id. If it is a search id, it will be used to search by id. If it is a search name, it will be used to search by name. If it is not provided, it will be ignored.

tin_matched
boolean | null

Filter by TIN match status. True returns searches where the TIN was matched, False returns searches where the TIN was not matched.

verified
boolean | null

Filter by verification status. True returns verified searches, False returns unverified searches.

business_website_match
boolean | null

Filter by business website match status. True returns searches where the website was matched, False returns searches where it was not.

business_name_match
enum<string> | null

Filter by business name match level. Values: NO_MATCH, SIMILAR, EXACT.

Available options:
NO_MATCH,
SIMILAR,
EXACT
business_officer_match
enum<string> | null

Filter by business officer match level. Values: NO_MATCH, SIMILAR, EXACT.

Available options:
NO_MATCH,
SIMILAR,
EXACT
registered_agent_match
enum<string> | null

Filter by registered agent match level. Values: NO_MATCH, SIMILAR, EXACT.

Available options:
NO_MATCH,
SIMILAR,
EXACT
business_address_match
enum<string> | null

Filter by business address match level. Values: NO_MATCH, CITY, STATE, SIMILAR, EXACT.

Available options:
NO_MATCH,
CITY,
STATE,
SIMILAR,
EXACT
limit
integer
default:10

Maximum number of records to return in a single page. Must be between 1 and 1000.

Required range: 1 <= x <= 1000
offset
integer | null

Number of records to skip from the beginning. Use 0 for the first page. Cannot be used with cursor.

Required range: x >= 0
cursor
string | null

Opaque pagination cursor token that identifies the position in the result set. Use the cursor from the previous response to get the next page. Cannot be used with offset.

start_date
string<date> | null

Filter records created on or after this date (format: YYYY-MM-DD).

end_date
string<date> | null

Filter records created on or before this date (format: YYYY-MM-DD).

tz
string
default:UTC

IANA timezone identifier used to interpret start_date and end_date (defaults to UTC).

Examples:

"UTC"

"America/Los_Angeles"

"Europe/London"

Response

List of business searches.

id
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:
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-08-31T10:31:07.796090"

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.

Example:
user
UserAttributionResponse (v1) · object | null

Details on the User who performed the search.

search_address
AddressSummaryResponse (v1) · object | null

The sanitized address inputted in the search.

officer_names
string[] | null

The officer names inputted in the search.

Example:
alternative_names
string[] | null

The alternative names inputted in the search.

Example:
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"

email
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.

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-08-31T10:31:07.796101"

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.

error
string | null

Any errors that occurred.

warnings
string[]

Any warnings that occurred.

Example:
business
BusinessSummaryResponse (v1) · object | null

A summary of the found business - contains the business UUID.

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"