v1

latestOpenAPI 3.1.02026-07-241695611.0 MB
Webhook Events

Business Search Legacy Updated

Emitted when a Business search has been updated. E.g. if the IRS was down for tin matching, the search may be updated at a later date with the correct tin_matched result.

postWebhookBusinessSearch.updated.legacy

Payload

Example payload

{
  "search": {
    "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"
  },
  "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"
  }
}

Response

Successful Response

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