v1

latestOpenAPI 3.1.02026-07-241695611.0 MB

Post Search

Create a new business search.

Supports both the legacy Accept: application/vnd.osiris.sync+json header (v1 backward compatibility) and the new Prefer header (RFC 7240) for controlling sync/async execution. When both are present, Prefer takes precedence.

post/searches

Headers

Preferstring nullable

Request execution preference (RFC 7240). Use respond-async for asynchronous execution, or wait=N to specify a synchronous timeout hint in seconds. When present, takes precedence over the legacy Accept header sync flag.

Acceptstring nullable

The MIME type of the response to accept.

Example:application/json

The MIME type of the response to accept.

Request body

namestring required

The name of the business to search for.

addressstring required

The address of the business to search for.

officer_namesstring[] nullable

The officer names to include in the search.

websitestring uri nullable

The website to include in the search.

phone_numberstring nullable

The phone number to include in the search.

emailstring nullable

The email to include in the search.

alternative_namesstring[] nullable

The alternative names to include in the search.

tinstring nullable

The TIN/EIN to search for.

optionsBusinessSearchOptions[]

Optional features to enable during search execution.

reference_idstring nullable

An optional reference ID to associate with the search request.

Example request

{
  "name": "White, Floyd and Cook",
  "address": "155 Carla Circles Jordanfurt, OK 59066",
  "officer_names": [
    "Nathan Harrington",
    "Alexander Wolfe"
  ],
  "website": "https://www.figueroa.com/",
  "phone_number": "436-502-9710",
  "email": "zacharymoore@example.com",
  "alternative_names": [
    "Joe's Pizza",
    "Joe's Pizzeria"
  ],
  "tin": "732842774",
  "options": [
    "Order.WebsiteAnalysis"
  ],
  "reference_id": "Search1234"
}

Response

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": "Levine-Santos",
    "addresses": [
      {
        "street": "913 Hendrix Gardens Suite 492",
        "city": "Jasonfurt",
        "zip": "19773",
        "latitude": 38.03012,
        "longitude": 78.47665,
        "sources": [
          "Online",
          "SOS"
        ]
      }
    ],
    "phone_numbers": [
      "251-829-8026"
    ],
    "email": "kathleenholmes@example.com",
    "website": "http://www.cruz-adkins.net/",
    "social_profiles": [
      {
        "site": "instagram",
        "username": "certifiedpowerinc",
        "metadata": {
          "is_business_account": true,
          "has_business_address": true,
          "bio": "Professional roofing services since 2010 🏠",
          "followers_count": 1250,
          "phone_number": "+12125551234",
          "email": "contact@business.com",
          "address": "123 Main St, Anytown, USA",
          "business_website": "https://www.business.com"
        },
        "found_on": [
          "FOUND_WEBSITE"
        ],
        "url": "https://www.instagram.com/certifiedpowerinc"
      }
    ],
    "reviews": [
      {
        "url": "https://www.yelp.com/biz/certified-power-inc-mundelein",
        "rating": 4.5,
        "volume": 23,
        "summary": "5 reviews mention that the service was great and the owner was very helpful.",
        "phone_number": "+12125551234",
        "address": "123 Main St, Anytown, USA",
        "business_website": "https://www.example.com",
        "reviews": [
          {
            "username": "John Doe",
            "text": "This is a great review!",
            "date": "2024-01-01",
            "rating": 5
          }
        ],
        "metadata": {
          "open_state": "Open",
          "types": [
            "Restaurant",
            "Italian restaurant"
          ]
        }
      }
    ],
    "directory_listings": [
      {
        "source": "bbb.org",
        "url": "https://www.bbb.org/us/ca/modesto/profile/plumber/joes-plumbing-1234",
        "category": "Plumbing Contractor",
        "business_name": "Joe's Plumbing & Heating"
      }
    ],
    "ein": "871888915",
    "incorporation_date": "2011-11-27",
    "months_in_business": 256,
    "primary_address": {
      "street": "913 Hendrix Gardens Suite 492",
      "city": "Jasonfurt",
      "zip": "19773",
      "latitude": 38.03012,
      "longitude": 78.47665
    },
    "alternative_names": [
      "Ramos, Garcia and Good"
    ],
    "registrations": [
      {
        "name": "Garcia, Hernandez and Woods",
        "issue_date": "2024-01-01",
        "inactive_date": "2024-06-01",
        "dissolution_date": "2024-06-01",
        "file_number": "867124",
        "address": {
          "street": "913 Hendrix Gardens Suite 492",
          "city": "Jasonfurt",
          "zip": "19773",
          "latitude": 38.03012,
          "longitude": 78.47665
        },
        "standing": "In Good Standing",
        "registered_agent": {
          "name": "Jeremy Crawford",
          "address": {
            "street": "913 Hendrix Gardens Suite 492",
            "city": "Jasonfurt",
            "zip": "19773",
            "latitude": 38.03012,
            "longitude": 78.47665
          }
        },
        "officers": [
          {
            "name": "Tyler Johnson",
            "titles": [
              "CEO",
              "Founder"
            ]
          }
        ]
      }
    ],
    "business_officers": [
      {
        "name": "Philip Mcguire",
        "titles": [
          "CEO",
          "Founder"
        ],
        "states": [
          "CA",
          "NY"
        ],
        "sources": [
          "Online",
          "SOS"
        ]
      }
    ],
    "predicted_naics": [
      {
        "code": "336111",
        "title": "Automobile Manufacturing",
        "accuracy": 1,
        "keywords": [
          "Automobiles",
          "Manufacturing",
          "Cars",
          "Trucks"
        ],
        "reasoning": "Based on homepage content mentioning automobile manufacturing and assembly processes."
      }
    ],
    "watchlist_hits": [
      {
        "code": "DMF",
        "count": 1,
        "details": [
          {
            "address": "123 Main St",
            "date_of_birth": "1980-01-01",
            "name": "John Doe"
          }
        ]
      }
    ],
    "sec_registrations": [
      {
        "cik": "320193",
        "tickers": [
          "NTDOY"
        ],
        "exchanges": [
          "OTC"
        ]
      }
    ],
    "url": "https://api.baselayer.com/businesses/9083e7e2-1f6b-11ef-8f0f-1edb1b067314",
    "console_url": "https://console.baselayer.com/business/9083e7e2-1f6b-11ef-8f0f-1edb1b067314",
    "phone_number": "955-714-3269",
    "address": "63788 Paige Lane Cooperfurt, MI 10037"
  },
  "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"
}