v1

latestOpenAPI 3.1.02026-07-241695611.0 MB

Business

Get Business Searches

List BusinessSearches that resolved to this business, newest first.

Scoped to the caller's dominant scope so callers only see searches their own organization (or application) ran.

get/businesses/{id}/searches

Path parameters

idstring uuid required

The unique identifier of the Business to list searches for.

Example:412a49b5-7466-426b-bf1e-081b00b54576

The unique identifier of the Business to list searches for.

Query parameters

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.

Response

Paginated list of BusinessSearches that resolved to this business, newest first. Scoped to the caller's dominant scope (organization or application).

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"
  }
]