---
title: "BusinessSearch.completed"
method: POST
path: "BusinessSearch.completed"
tags: ["Webhook Events"]
---

# BusinessSearch.completed

`POST BusinessSearch.completed` (webhook)

Emitted when a Business search has completed and business detail results are available.

## Payload

- V1BusinessSearchCompletedWebhook
  - `__event__` WebhookMetadata
    - `type` 'BusinessSearch.submitted' | 'BusinessSearch.responded' | 'BusinessSearch.completed' | 'BusinessSearch.failed' | 'BusinessSearch.cancelled' | 'BusinessSearch.updated' | 'PersonSearch.submitted' | 'PersonSearch.completed' | 'PersonSearch.failed' | 'PersonSearch.updated' | 'DMFSearch.submitted' | 'DMFSearch.completed' | 'DMFSearch.failed' | 'LiensSearch.submitted' | 'LiensSearch.completed' | 'LiensSearch.failed' | 'LienFiling.created' | 'LienFiling.updated' | 'LienFiling.deleted' | 'DocketSearch.submitted' | 'DocketSearch.completed' | 'DocketSearch.failed' | 'DocketDetailsSearch.submitted' | 'DocketDetailsSearch.completed' | 'DocketDetailsSearch.failed' | 'DocketExhibitSearch.submitted' | 'DocketExhibitSearch.completed' | 'DocketExhibitSearch.failed' | 'APIKey.created' | 'APIKey.deleted' | 'OnboardingSession.completed' | 'Order.created' | 'RegistrationEnrichment.submitted' | 'RegistrationEnrichment.completed' | 'RegistrationEnrichment.failed' | 'NAICSPredictionRequest.submitted' | 'NAICSPredictionRequest.completed' | 'NAICSPredictionRequest.failed' | 'WebsiteAnalysisRequest.submitted' | 'WebsiteAnalysisRequest.completed' | 'WebsiteAnalysisRequest.failed' | 'WebPresenceRequest.submitted' | 'WebPresenceRequest.completed' | 'WebPresenceRequest.failed' | 'PortfolioItem.created' | 'PortfolioItem.updated' | 'PortfolioItem.deleted' | 'PortfolioGroup.created' | 'PortfolioGroup.updated' | 'PortfolioGroup.deleted' | 'TINVerification.submitted' | 'TINVerification.completed' | 'TINVerification.failed' | 'AdverseMediaSearch.submitted' | 'AdverseMediaSearch.completed' | 'AdverseMediaSearch.failed' | 'EmployeeVerificationRequest.submitted' | 'EmployeeVerificationRequest.completed' | 'EmployeeVerificationRequest.failed' | 'InternationalBusinessSearch.submitted' | 'InternationalBusinessSearch.completed' | 'InternationalBusinessSearch.failed', required — The canonical list of supported Webhook events. Every Webhook event sent via the notifier must be registered here. An exhaustive match is used against this enumeration to ensure that all events are valid and have corresponding rendering logic. @see WebhookNotifier.render_payload
    - `origin` 'api' | 'console' | 'mcp' | 'onboarding'
    - `organization_id` string, nullable
    - `application_id` string, nullable
    - `external_id` string, nullable
    - `application_type` string, nullable
  - `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` V1BusinessResponse — Response model for business data. This model defines the complete structure for business-related API responses.
    - `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.
    - `structure` 'SOLE_PROPRIETORSHIP' | 'GENERAL_PARTNERSHIP' | 'LLC' | 'LLP' | 'LLLP' | 'LP' | 'C_CORPORATION' | 'S_CORPORATION' | 'B_CORPORATION' | 'NONPROFIT' | 'COOPERATIVE' | 'TRUST' | 'PROFESSIONAL_ASSOCIATION' | 'PROFESSIONAL_CORPORATION' | 'TRADE_NAME' | 'BANK' | 'CREDIT_UNION' | 'INSURANCE' | 'OTHER'
    - `addresses` V1AddressSummaryResponseWithSources[] — All addresses found associated with this business entity.
      - `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.
      - `sources` V1EntitySource[] — The sources of the address.
    - `phone_numbers` string[] — All phone numbers found associated with this business entity.
    - `email` string, nullable — The main email found associated with this business entity.
    - `website` string, nullable — The website found associated with this business entity.
    - `social_profiles` V1DiscoveredSocialProfile[], nullable — The list of social media profiles potentially associated with this business entity that were identified by searching the web.
      - `site` 'linked_in:personal' | 'linked_in:company' | 'twitter' | 'instagram' | 'facebook' | 'youtube' | 'tiktok' | 'pinterest' | 'x', required — The type of social profile.
      - `username` string, required — The username of the social profile.
      - `confidence` 'high' | 'medium' | 'low'
      - `metadata` union — The metadata of the social profile. Based on the site of the social profile.
        - V1DiscoveredInstagramMetadata — Instagram-specific metadata extracted from a verified business profile.
          - `is_private` boolean, nullable — Whether the Instagram account is private
          - `is_business_account` boolean, nullable — Whether this is an Instagram business account
          - `has_business_address` boolean, nullable — Whether the business address is displayed on the Instagram profile
          - `bio` string, nullable — Instagram bio/description content
          - `followers_count` integer, nullable — Number of followers if displayed
          - `phone_number` string, nullable — Business phone number if found in profile
          - `email` string, nullable — Business email address if found in profile
          - `address` string, nullable — Business address if found in profile
          - `business_website` string, nullable — Business website URL if found in profile
        - V1DiscoveredLinkedInMetadata — LinkedIn-specific metadata extracted from a verified business profile.
          - `company_size_range` string, nullable — Company size range as displayed on LinkedIn (e.g., '11-50 employees')
          - `industry` string, nullable — Industry classification from LinkedIn
          - `followers_count` integer, nullable — Number of followers if displayed
          - `phone_number` string, nullable — Business phone number if found in profile
          - `bio` string, nullable — LinkedIn bio/description content
          - `email` string, nullable — Business email address if found in profile
          - `number_of_employees` integer, nullable — Number of employees (LinkedIn only)
          - `business_website` string, nullable — Business website URL if found in profile
        - V1DiscoveredFacebookMetadata — Facebook-specific metadata extracted from a verified business profile.
          - `is_business_page` boolean, nullable — Whether this is a Facebook business page vs personal profile
          - `has_reviews` boolean, nullable — Whether the Facebook page has customer reviews
          - `check_ins_count` integer, nullable — Number of check-ins at this business location
          - `followers_count` integer, nullable — Number of followers if displayed
          - `bio` string, nullable — Facebook bio/description content
          - `phone_number` string, nullable — Business phone number if found in profile
          - `address` string, nullable — Business address if found in profile
          - `email` string, nullable — Business email address if found in profile
          - `business_website` string, nullable — Business website URL if found in profile
        - V1DiscoveredXMetadata — Twitter/X-specific metadata extracted from a verified business profile.
          - `is_verified` boolean, nullable — Whether the Twitter/X account is verified
          - `follower_count` integer, nullable — Number of followers if displayed
          - `bio` string, nullable — Twitter/X bio/description content
          - `joined_date` string, nullable — When the account joined Twitter/X (e.g., 'Joined February 2010')
          - `address` string, nullable — Business address if found in profile
          - `phone_number` string, nullable — Business phone number if found in profile
          - `email` string, nullable — Business email address if found in profile
          - `business_website` string, nullable — Business website URL if found in profile
        - V1DiscoveredYouTubeMetadata — YouTube-specific metadata extracted from a verified business channel.
          - `is_verified` boolean, nullable — Whether the YouTube channel is verified
          - `subscriber_count` integer, nullable — Number of subscribers if displayed
          - `channel_type` string, nullable — Type of channel (e.g., 'Business', 'Brand', 'Personal')
          - `has_business_email` boolean, nullable — Whether business contact email is provided
          - `channel_description` string, nullable — Channel about/description content
          - `followers_count` integer, nullable — Number of followers if displayed
          - `phone_number` string, nullable — Business phone number if found in profile
          - `email` string, nullable — Business email address if found in profile
          - `business_website` string, nullable — Business website URL if found in profile
        - V1DiscoveredTikTokMetadata — TikTok-specific metadata extracted from a verified business profile.
          - `is_verified` boolean, nullable — Whether the TikTok account is verified
          - `is_business_account` boolean, nullable — Whether this is a TikTok business account
          - `follower_count` integer, nullable — Number of followers if displayed
          - `bio` string, nullable — TikTok bio/description content
          - `has_business_website` boolean, nullable — Whether a business website link is provided
          - `phone_number` string, nullable — Business phone number if found in profile
          - `email` string, nullable — Business email address if found in profile
          - `business_website` string, nullable — Business website URL if found in profile
        - V1DiscoveredPinterestMetadata — Pinterest-specific metadata extracted from a verified business profile.
          - `follower_count` integer, nullable — Number of followers if displayed
          - `monthly_views` integer, nullable — Monthly views count if displayed
          - `bio` string, nullable — Pinterest profile bio/description content
          - `has_business_website` boolean, nullable — Whether a business website link is provided
          - `phone_number` string, nullable — Business phone number if found in profile
          - `email` string, nullable — Business email address if found in profile
          - `business_website` string, nullable — Business website URL if found in profile
      - `found_on` string[] — Location(s) where this social profile was found: InputWebsite (user-provided website), FoundWebsite (discovered website)
      - `url` string, required — The URL of the social profile.
    - `reviews` V1DiscoveredReview[], nullable — The list of customer reviews potentially associated with this business entity that were identified by searching the web.
      - `source` 'yelp' | 'google' | 'trustpilot' | 'tripadvisor' | 'other'
      - `url` string, required — The URL of the review.
      - `confidence` 'high' | 'medium' | 'low'
      - `rating` number, nullable — The numeric rating of the review (e.g., 4.5 out of 5).
      - `volume` integer, nullable — The number of reviews.
      - `summary` string, nullable — Overall summary of the reviews and general sentiment towards the business.
      - `phone_number` string, nullable — Business phone number if found in profile
      - `address` string, nullable — Business address if found in profile
      - `business_website` string, nullable — Business website if found in profile
      - `reviews` V1ReviewDetail[] — Individual reviews for this business.
        - `username` string, required — The username of the reviewer.
        - `text` string, required — The text of the review.
        - `date` string, date, required — The date of the review.
        - `rating` integer, required — The rating of the review.
      - `metadata` V1GoogleReviewMetadata — Google Maps-specific metadata for a discovered review.
        - `open_state` string, nullable — Current open/closed state from Google Maps.
        - `operating_hours` object, nullable — Operating hours data from Google Maps.
        - `description` string, nullable — Business description from Google Maps.
        - `types` string[], nullable — Business type tags from Google Maps.
        - `service_options` object, nullable — Service options from Google Maps (e.g., dine-in, takeout).
    - `directory_listings` V1DirectoryListingResponse[], nullable — Directory listings (BBB, Yelp, etc.) discovered during website analysis, including business category, contact info, and address.
      - `source` string, nullable — Directory domain where the listing was found.
      - `url` string, nullable — URL of the directory page that was scraped.
      - `category` string, nullable — Business category assigned by the directory site.
      - `business_name` string, nullable — Business name as listed on the directory (may be a DBA).
      - `phone_number` string, nullable — Phone number from the directory listing.
      - `email` string, nullable — Email address from the directory listing.
      - `business_website` string, nullable — Website URL listed on the directory page for the business.
      - `address` string, nullable — Physical address from the directory listing.
      - `people` V1DirectoryListingPerson[] — Officers, principals, or key people listed on the directory page.
        - `name` string, required
        - `title` string, nullable
    - `ein` string, nullable — The EIN/TIN found associated with this business entity.
    - `incorporation_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'
    - `incorporation_date` string, date, nullable — The date when the business first incorporated.
    - `months_in_business` integer, nullable — The number of months elapsed since the incorporation date.
    - `primary_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.
    - `alternative_names` string[] — A list of alternative names (e.g. DBAs) found associated with the business entity.
    - `registrations` V1RegistrationResponse[] — The corporate registrations associated with the business entity.
      - `id` string, uuid, required — The unique identifier of the corporate registration.
      - `name` string, required — The name on the registration.
      - `issue_date` string, date, nullable — The date the registration was issued.
      - `inactive_date` string, date, nullable — The date the registration became inactive.
      - `dissolution_date` string, date, nullable — The date the registration was dissolved in the given state.
      - `file_number` string, required — The file number of the registration.
      - `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
      - `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.
      - `registration_type` 'foreign' | 'domestic' | 'unknown' — Status of the corporate registration filing.
      - `status` 'active' | 'inactive' | 'unknown', required — Status field indicating whether the corporate registration filing is active or inactive.
      - `standing` string, nullable — The standing of the registration.
      - `registered_agent` V1CorporateRegistrationAgentResponse — Response model for corporate registration agent data.
        - `name` string, required — The name of the registered agent.
        - `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.
      - `officers` V1RegistrationOfficerResponse[] — The officers listed on the registration.
        - `name` string, required — The name of the officer.
        - `titles` string[] — The titles associated with the officer.
    - `business_officers` V1BusinessOfficerResponse[] — The officers associated with the business entity.
      - `name` string, required — The name of the officer.
      - `titles` string[] — The titles associated with the officer.
      - `states` V1StateAbbreviation[] — The states where the officer is registered.
      - `sources` V1EntitySource[] — The sources of the officer.
    - `predicted_naics` V1PredictedNaicsResponse[] — The predicted NAICS code(s) for the business entity.
      - `code` string, required — The predicted NAICS code for the business.
      - `title` string, required — The title of the predicted NAICS code.
      - `accuracy` number, nullable — The accuracy of the NAICS code prediction.
      - `keywords` string[], nullable — Any keywords associated with the NAICS code to indicate area of business activity.
      - `mcc_codes` V1MCC[], nullable — List of MCC codes associated with the NAICS code.
        - `code` string, required — The 4-digit MCC.
        - `description` string, nullable — Description of the MCC.
        - `mastercard_risk` boolean, nullable — Indicates if there is a risk associated with Mastercard transactions.
        - `visa_risk_tier` 1 | 2 | 3
      - `sic_codes` V1SICCode[], nullable — List of SIC codes associated with the NAICS code.
        - `code` string, required — The 4-digit SIC code.
        - `description` string, nullable — Description of the SIC code.
      - `risk_level` 'high' | 'medium' | 'low' | 'no_risk'
      - `reasoning` string, nullable — Explanation of why this specific NAICS code was chosen for the business.
    - `watchlist_hits` V1WatchlistHitResponse[] — The watchlist hits associated with the business entity.
      - `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.
    - `sec_registrations` V1SecRegistrationResponse[] — SEC EDGAR registrations linked to this business. Empty when no SEC registration is linked.
      - `cik` string, required — SEC Central Index Key assigned to the registrant.
      - `tickers` string[], required — All stock ticker symbols for this registrant.
      - `exchanges` string[], required — All exchanges this registrant's securities are listed on.
      - `sec_edgar_url` string, uri, required — Direct link to this registrant's SEC EDGAR page.
    - `url` string, uri, required — The URL to the business details.
    - `console_url` string, uri, required — The URL to the business details in the console.
    - `revenue` unknown
    - `phone_number` string, nullable — The primary phone number found associated with the business.
    - `address` string, nullable, required — The primary address associated with the business entity.
  - `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.

## Acknowledgement `200`

Successful Response

- unknown

## 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)