Skip to main content
WEBHOOK

Body

application/json
​
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-10-22T15:43:38.091242"

​
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"

​
__event__
WebhookMetadata · object
​
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.

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

​
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-10-22T15:43:38.091255"

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

​
reason_codes
enum<string>[]

The reason codes that hold on this result, sorted: conditions a rules engine can branch on. Each code's category, recommended severity and description are served by GET /reason_codes. Empty when none hold.

Every reason code Baselayer has ever issued.

Members are named exactly as their value so the code a customer sees is the code a developer greps for. A member is never removed: rows that recorded it still name it.

Available options:
ADDRESS_FAILED_TO_NORMALIZE,
ENTITY_NOT_FOUND,
BUSINESS_NAME_NO_MATCH,
NO_ACTIVE_REGISTRATIONS,
DOMESTIC_REGISTRATION_INACTIVE,
SOLE_REGISTRATION_STATUS_UNKNOWN,
ENTITY_AGE_UNDER_7D,
ENTITY_AGE_UNDER_30D,
ENTITY_AGE_UNDER_90D,
ENTITY_AGE_UNDER_6M,
ENTITY_AGE_UNDER_12M,
TIN_MISMATCH,
TIN_IS_SSN,
ADDRESS_NO_MATCH,
ADDRESS_PARTIAL_MATCH,
SEARCH_ADDRESS_UNDELIVERABLE,
SEARCH_ADDRESS_PO_BOX,
SEARCH_ADDRESS_CMRA,
SEARCH_ADDRESS_RESIDENTIAL,
PRIMARY_ADDRESS_UNDELIVERABLE,
PRIMARY_ADDRESS_PO_BOX,
PRIMARY_ADDRESS_CMRA,
PRIMARY_ADDRESS_RESIDENTIAL,
NO_OFFICER_MATCH,
SUBMITTED_DOMAIN_UNDER_7D,
DISCOVERED_DOMAIN_UNDER_7D,
TAX_LIEN_ACTIVE,
TAX_LIEN_PAST,
UCC_LIEN_ACTIVE,
BANKRUPTCY_ACTIVE,
BANKRUPTCY_RECENT,
LITIGATION_ACTIVE,
LITIGATION_RECENT,
NETWORK_HIGH_VELOCITY,
NETWORK_HIGH_APPLICATION_COUNT,
ADDRESS_MISMATCH,
NETWORK_NO_HISTORY
Example:
​
error
string | null

Any errors that occurred.

​
warnings
string[]

Any warnings that occurred.

Example:
​
business
BusinessResponse (v1) · object | null

A representation of the Business identified by the Search.

​
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"

Response

Successful Response