v1

latestOpenAPI 3.1.02026-07-241695611.0 MB

Webhook Events

BusinessSearch.submitted

Emitted when a Business search has been submitted for processing.

postWebhookBusinessSearch.submitted

Payload

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 payload

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

Response

Successful Response

{"stackTrail":"webhooks:BusinessSearch.submitted:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}