v1

latestOpenAPI 3.1.02026-07-241695611.0 MB

Get Searches

Retrieve a list of business searches.

get/searches

Query parameters

qstring nullable

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_matchedboolean nullable

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

verifiedboolean nullable

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

business_website_matchboolean nullable

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

business_name_match'NO_MATCH' | 'SIMILAR' | 'EXACT'

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

business_officer_match'NO_MATCH' | 'SIMILAR' | 'EXACT'

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

registered_agent_match'NO_MATCH' | 'SIMILAR' | 'EXACT'

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

business_address_match'NO_MATCH' | 'CITY' | 'STATE' | 'SIMILAR' | 'EXACT'

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

limitinteger

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

offsetinteger nullable

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

cursorstring nullable

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_datestring date nullable

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

end_datestring date nullable

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

tzstring

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

Example:UTC

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

Response

List of business searches.

idstring uuid required

The unique identifier of the search.

optionsstring[] required

Optional features enabled during search execution.

state'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' required

namestring required

The name inputted in the search.

addressstring required

The address string inputted in the search.

officer_namesstring[] nullable

The officer names inputted in the search.

alternative_namesstring[] nullable

The alternative names inputted in the search.

websitestring nullable

The website inputted in the search.

phone_numberstring nullable

The phone number inputted in the search.

emailstring nullable

The email inputted in the search.

tinstring nullable

The TIN/EIN inputted in the search.

reference_idstring nullable

The reference ID inputted in the search.

tin_matchedboolean nullable

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.

tin_match_type'SSN' | 'EIN' | 'UNKNOWN'

tin_potential_matchstring nullable

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.

business_name_match'NO_MATCH' | 'SIMILAR' | 'EXACT'

business_address_match'NO_MATCH' | 'CITY' | 'STATE' | 'SIMILAR' | 'EXACT'

business_officer_match'NO_MATCH' | 'SIMILAR' | 'EXACT'

registered_agent_match'NO_MATCH' | 'SIMILAR' | 'EXACT'

business_website_matchboolean nullable

Does the inputted website match the found business website?

business_website_redirect_matchboolean nullable

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.

search_address_validation_level'FULL' | 'PARTIAL' | 'INVALID'

created_atstring date-time required

The datetime the search was created.

updated_atstring date-time nullable

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

verifiedboolean nullable

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

errorstring nullable

Any errors that occurred.

warningsstring[]

Any warnings that occurred.

urlstring uri required

The API URL to retrieve the search.

status_urlstring uri required

The API URL to retrieve the status of the search.

business_urlstring uri nullable required

The API URL to retrieve the business details.

console_urlstring uri

The URL to the search details in the console.

Example response

[
  {
    "options": [
      "Order.WebsiteAnalysis"
    ],
    "orderables": [
      {
        "id": "c97dd8d5-e7bb-444b-a943-cca696772a01",
        "option": "Order.WebsiteAnalysis",
        "type": "WebsiteAnalysisRequest",
        "url": "https://api.baselayer.com/website_analysis_requests/c97dd8d5-e7bb-444b-a943-cca696772a01"
      }
    ],
    "user": {
      "first_name": "Austin",
      "last_name": "Taylor",
      "email": "jessicasimpson@example.com"
    },
    "name": "Acme Corporation",
    "address": "1640 Riverside Drive, Hill Valley, CA",
    "search_address": {
      "street": "913 Hendrix Gardens Suite 492",
      "city": "Jasonfurt",
      "zip": "19773",
      "latitude": 38.03012,
      "longitude": 78.47665
    },
    "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_potential_match": "Baselayer",
    "watchlist_hits": [
      {
        "code": "DMF",
        "count": 1,
        "details": [
          {
            "address": "123 Main St",
            "date_of_birth": "1980-01-01",
            "name": "John Doe"
          }
        ]
      }
    ],
    "business_website_match": true,
    "business_website_redirect_match": true,
    "created_at": "2026-07-16T19:24:27.762682",
    "updated_at": "2026-07-16T19:24:27.762696",
    "verified": true,
    "scores": [
      {
        "score": 95,
        "rating": "A"
      }
    ],
    "warnings": [
      "IRS Validation is unavailable."
    ],
    "business": {
      "name": "Hamilton-Olson",
      "address": "63788 Paige Lane Cooperfurt, MI 10037",
      "phone_number": "955-714-3269",
      "email": "javier01@example.net",
      "website": "https://jones.com/",
      "url": "https://api.baselayer.com/businesses/9083e7e2-1f6b-11ef-8f0f-1edb1b067314",
      "console_url": "https://console.baselayer.com/business/9083e7e2-1f6b-11ef-8f0f-1edb1b067314"
    },
    "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",
    "console_url": "https://console.baselayer.com/business/febe48f6-1f57-11ef-8bbf-1edb1b067314"
  }
]

All 226 operations