---
title: "Get Searches"
method: GET
path: "/searches"
tags: ["Search"]
---

# Get Searches

`GET /searches`

Retrieve a list of business searches.

## Query parameters

- `q` string, 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_matched` boolean, nullable — Filter by TIN match status. True returns searches where the TIN was matched, False returns searches where the TIN was not matched.
- `verified` boolean, nullable — Filter by verification status. True returns verified searches, False returns unverified searches.
- `business_website_match` boolean, 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'
- `business_officer_match` 'NO_MATCH' | 'SIMILAR' | 'EXACT'
- `registered_agent_match` 'NO_MATCH' | 'SIMILAR' | 'EXACT'
- `business_address_match` 'NO_MATCH' | 'CITY' | 'STATE' | 'SIMILAR' | 'EXACT'
- `limit` integer — Maximum number of records to return in a single page. Must be between 1 and 1000.
- `offset` integer, nullable — Number of records to skip from the beginning. Use 0 for the first page. Cannot be used with cursor.
- `cursor` string, 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_date` string, date, nullable — Filter records created on or after this date (format: YYYY-MM-DD).
- `end_date` string, date, nullable — Filter records created on or before this date (format: YYYY-MM-DD).
- `tz` string — IANA timezone identifier used to interpret start_date and end_date (defaults to UTC).

## Response `200`

List of business searches.

- V1BusinessSearchResponse[]
  - `id` string, uuid, required — The unique identifier of the search.
  - `options` string[], required — Optional features enabled during search execution.
  - `orderables` Orderable[] — 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.
    - `type` 'WebsiteAnalysisRequest' | 'NAICSPredictionRequest', required
    - `id` string, uuid, required — The unique identifier of the orderable object.
    - `url` string, required — The URL to the orderable object.
    - `option` 'Order.WebsiteAnalysis' | 'Order.NaicsPrediction' | 'Order.Pep' | 'Order.Enhanced', required
  - `user` V1UserAttributionResponse — Response model for user attribution operations. This model defines the structure for user attribution API responses.
    - `id` string, uuid, required — Unique identifier for the user.
    - `first_name` string, required — First name of the user.
    - `last_name` string, required — Last name of the user.
    - `email` string, required — Email address of the user.
  - `state` 'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
  - `name` string, required — The name inputted in the search.
  - `address` string, required — The address string inputted in the search.
  - `search_address` V1AddressSummaryResponse — Response model for address summary data. This model defines the structure for address summary API responses.
    - `id` string, uuid, required — Unique identifier for the address.
    - `street` string, required — Street name of the address.
    - `city` string, required — City name of the address.
    - `state` 'AL' | 'AK' | 'AZ' | 'AR' | 'CA' | 'CO' | 'CT' | 'DE' | 'DC' | 'FL' | 'GA' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MI' | 'MN' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'OH' | 'OK' | 'OR' | 'PA' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VT' | 'VA' | 'WA' | 'WV' | 'WI' | 'WY' | 'PR' | 'VI' | 'AE' | 'AA' | 'AP' | 'GU' | 'AS', required
    - `zip` string, required — Zip code of the address.
    - `latitude` number, required — Latitude of the address.
    - `longitude` number, required — Longitude of the address.
    - `rdi` 'Residential' | 'Commercial'
    - `deliverable` boolean, nullable — Indicates whether the address is deliverable.
    - `cmra` boolean, nullable — Indicates whether the address is a Commercial Mail Receiving Agency (CMRA).
    - `url` string, uri, nullable — The URL to the address details.
    - `delivery_type` 'FIRM' | 'GENERAL_DELIVERY' | 'HIGH_RISE' | 'POST_OFFICE' | 'RURAL_ROUTE' | 'STREET' — Enum representing the different types of USPS delivery points. Used to classify addresses based on how mail is delivered to them.
  - `officer_names` string[], nullable — The officer names inputted in the search.
  - `alternative_names` string[], nullable — The alternative names inputted in the search.
  - `website` string, nullable — The website inputted in the search.
  - `phone_number` string, nullable — The phone number inputted in the search.
  - `email` string, nullable — The email inputted in the search.
  - `tin` string, nullable — The TIN/EIN inputted in the search.
  - `reference_id` string, nullable — The reference ID inputted in the search.
  - `tin_matched` boolean, 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_match` string, 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.
  - `watchlist_hits` V1WatchlistHitResponse[] — The watchlist hits associated with the searched business.
    - `code` string, required — The code of the watchlist data source.
    - `name` 'Death Master File' | 'Department of Treasury, Office of Foreign Assets Control' | 'Politically Exposed Persons' | 'IRS Exempt Organizations List' | 'FBI Wanted List' | 'Department of Commerce, Consolidated Screening List' | 'Consolidated Canadian Autonomous Sanctions List' | 'HHS OIG List of Excluded Individuals/Entities' | 'Baselayer Fraud Consortium', required
    - `count` integer, required — The number of hits found in the watchlist data source.
    - `details` object[], nullable — The details of the watchlist hits.
  - `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_match` boolean, nullable — Does the inputted website match the found business website?
  - `business_website_redirect_match` boolean, 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_at` string, date-time, required — The datetime the search was created.
  - `updated_at` string, date-time, nullable — The datetime the search was updated at (generally when the search completed).
  - `verified` boolean, nullable — Indicates whether the found business was a close enough match to be considered verified.
  - `scores` V1ScoreResponse[], nullable — An array containing Baselayer's ratings.
    - `type` 'fraud' | 'risk' | 'kyb', required
    - `score` number, required — The score value.
    - `rating` string, required — The rating associated with the score.
  - `error` string, nullable — Any errors that occurred.
  - `warnings` string[] — Any warnings that occurred.
  - `business` V1BusinessSummaryResponse — Response model for business summary data.
    - `id` string, uuid, required — Unique identifier for the business.
    - `name` string, required — The name of the business, determined by the name found on the domestic registration.
    - `address` string, nullable — The primary address associated with the business entity.
    - `phone_number` string, nullable — The primary phone number found associated with the business.
    - `email` string, nullable — The primary email address found associated with the business.
    - `website` string, nullable — The primary website found associated with the business.
    - `url` string, uri — The URL to the business details.
    - `console_url` string, uri — The URL to the business details in the console.
  - `url` string, uri, required — The API URL to retrieve the search.
  - `status_url` string, uri, required — The API URL to retrieve the status of the search.
  - `business_url` string, uri, nullable, required — The API URL to retrieve the business details.
  - `console_url` string, uri — The URL to the search details in the console.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/baselayer/apis/baselayer-api-service.md) · [All operations](https://skmtc.net/baselayer/apis/baselayer-api-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baselayer/baselayer-api-service/versions/0cc89938bc26/schema)