--- title: "WebPresenceRequest.submitted" method: POST path: "WebPresenceRequest.submitted" tags: ["Webhook Events"] --- # WebPresenceRequest.submitted `POST WebPresenceRequest.submitted` (webhook) Emitted when a Web Presence request has been submitted for processing. ## Payload - union - V1WebPresenceRequestSubmittedWebhook - `root` union, required — The webhook payload data - V1USWebPresenceResponse - `request_type` 'UNITED_STATES', required — The type of web presence request. - `id` string, uuid, required — The ID of the Web Presence request - `state` 'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required - `created_at` string, date-time, required — The date and time when the Web Presence request was created. - `updated_at` string, date-time, nullable — The most recent date and time when the Web Presence request was updated. - `options` string[] — The options for the web presence request. - `name` string, required — The name of the business as it was input for the search. - `alternative_names` string[], nullable — Alternative names for the business (e.g., DBA names) - `address` string, nullable — The address of the business as it was input for the search. - `iso2_country_code` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'XK' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' — Enumeration of ISO 3166-1 alpha-2 country codes. Attributes: (Various country codes like Andorra = "AD", etc.) - `website` string, nullable — The website of the business as it was input for the search. - `officer_names` string[], nullable — A list of business officers related to the business as they were input for the search. - `phone_number` string, nullable — The phone number as it was input for the search. - `email` string, nullable — The email as it was input for the search. - `reference_id` string, nullable — An optional reference ID associated with the web presence request. - `business_address_match` 'NO_MATCH' | 'CITY' | 'STATE' | 'SIMILAR' | 'EXACT' - `business_address_match_sources` V1WebPresenceSource[], nullable — The sources where the best address match was found. Only populated when business_address_match is not NoMatch. - `phone_number_match` 'NO_MATCH' | 'EXACT' | 'AREA_CODE' - `phone_number_match_sources` V1WebPresenceSource[], nullable — The sources where the best phone number match was found. Only populated when phone_number_match is not NoMatch. - `email_match` 'NO_MATCH' | 'EXACT' | 'DOMAIN' - `email_match_sources` V1WebPresenceSource[], nullable — The sources where the best email match was found. Only populated when email_match is not NoMatch. - `people_match` boolean, nullable — True if at least one officer name matches a person discovered during web presence analysis (exact or similar). Only populated when officer_names were provided in the request. - `people_match_sources` V1WebPresenceSource[], nullable — The sources where the people match was found. - `business_website_match` boolean, nullable — Indicates whether the inputted website matches the found business entity. - `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. - `found_website` string, nullable — The discovered website of the business. - `website_accuracy` number, nullable — The confidence score of the discovered website. - `found_social_profiles` V1DiscoveredSocialProfile[], nullable — A list of discovered social profiles related to the business. - `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. - … - V1DiscoveredLinkedInMetadata — LinkedIn-specific metadata extracted from a verified business profile. - … - V1DiscoveredFacebookMetadata — Facebook-specific metadata extracted from a verified business profile. - … - V1DiscoveredXMetadata — Twitter/X-specific metadata extracted from a verified business profile. - … - V1DiscoveredYouTubeMetadata — YouTube-specific metadata extracted from a verified business channel. - … - V1DiscoveredTikTokMetadata — TikTok-specific metadata extracted from a verified business profile. - … - V1DiscoveredPinterestMetadata — Pinterest-specific metadata extracted from a verified business 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. - `input_social_profiles` V1DiscoveredSocialProfile[], nullable — Scraped social profiles from user-provided inputs. - `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. - … - V1DiscoveredLinkedInMetadata — LinkedIn-specific metadata extracted from a verified business profile. - … - V1DiscoveredFacebookMetadata — Facebook-specific metadata extracted from a verified business profile. - … - V1DiscoveredXMetadata — Twitter/X-specific metadata extracted from a verified business profile. - … - V1DiscoveredYouTubeMetadata — YouTube-specific metadata extracted from a verified business channel. - … - V1DiscoveredTikTokMetadata — TikTok-specific metadata extracted from a verified business profile. - … - V1DiscoveredPinterestMetadata — Pinterest-specific metadata extracted from a verified business 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. - `social_profiles_match` V1InputSocialProfileMatch[], nullable — Match results for user-provided social profile inputs. Each entry echoes back the original input (site, value) and indicates whether it was also independently found during organic social discovery. - `site` 'linked_in:personal' | 'linked_in:company' | 'twitter' | 'instagram' | 'facebook' | 'youtube' | 'tiktok' | 'pinterest' | 'x', required — The social media platform from the original input. - `value` string, required — The username, handle, or URL from the original input. - `matched` boolean, required — Whether this input social profile was successfully scraped and verified during discovery. - `found_reviews` V1DiscoveredReview[], nullable — A list of discovered reviews related to the business. - `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). - `found_directory_listings` V1DiscoveredDirectoryListing[], nullable — A list of discovered directory listings related to the business. - `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 - `website_analysis` V1WebsiteAnalysisDetails - `id` string, uuid, required — The ID of the Website Analysis request - `url` string, uri, required — The website URL that was analyzed as part of the Search. - `redirects` V1WebsiteRedirectInfo - `is_redirect_url` boolean, required — Indicates that this website performs a cross-domain redirect. - `redirects_to` string, required — The domain this website redirects to. - `parked` boolean, nullable, required — A boolean indicating if the website is suspected of being a parked domain. - `email_deliverable` boolean, nullable — A boolean indicating if the website is able to send and receive emails. - `phone_numbers` string[], nullable — The list of phone numbers that were identified on the analyzed website. - `emails` string[], nullable, required — The list of email addresses that were identified on the analyzed website. - `social_profiles` V1SocialProfile[], nullable, required — The list of social media profiles that were identified on the analyzed website. - `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. - `url` string, required — The URL of the social profile. - `addresses` V1AddressSummaryResponse[] — The list of mailing addresses that were identified on the analyzed website. - `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. - `people` V1WebsiteAnalysisPerson[], nullable — The list of people identified on the analyzed website. - `name` string, required - `titles` string[], required - `website_build_status` 'coming_soon' | 'inactive' | 'active' - `website_summary` string, nullable — A summary of the business based on the analyzed website content. - `console_url` string, uri, required — The URL to the Website Analysis details in the console. - `screenshot_url` string, uri, nullable — The URL to download the homepage screenshot of the analyzed website. - `whois_record` V1WhoIsRecordResponse - `domain_created_at` string, date-time, nullable, required — The date and time when the domain was first registered. - `domain_age_months` integer, nullable — The age of the domain since its creation in months. - `domain_updated_at` string, date-time, nullable, required — The date and time when the domain registration was last updated. - `domain_expires_at` string, date-time, nullable, required — The date and time when the domain registration is set to expire. - `registrar` string, nullable, required — The name of the domain registrar. - `ssl_validity` V1SSLValidityInfo — SSL certificate information with fraud-relevant signals. is_valid semantics: True: Certificate is valid and trusted False: Certificate is definitively invalid (expired, untrusted, revoked, etc.) None: Cannot determine (connection failed, timeout, non-HTTPS) - `is_valid` boolean, nullable — Whether the SSL certificate is valid (True=valid, False=invalid, None=indeterminate) - `reason` 'CERTIFICATE_EXPIRED' | 'HOSTNAME_MISMATCH' | 'SELF_SIGNED' | 'REVOKED' | 'UNTRUSTED_AUTHORITY' | 'VERIFICATION_FAILED' | 'NOT_HTTPS' | 'CONNECTION_TIMED_OUT' | 'UNABLE_TO_CONNECT' | 'SERVER_DISCONNECTED' | 'SERVER_ERROR' | 'CONNECTION_ERROR' — Reasons why an SSL certificate check failed or could not be determined. Used when is_valid is False (certificate invalid) or None (indeterminate). - `issuer` string, nullable — Certificate issuer (CA) common name - `subject` string, nullable — Certificate subject common name - `issued_date` string, date-time, nullable — When the certificate was issued - `expiry_date` string, date-time, nullable — When the certificate expires - `days_until_expiry` integer, nullable — Days until certificate expires (negative if expired) - `cert_age_days` integer, nullable — Days since certificate was issued - `certificate_type` 'DV' | 'OV' | 'EV' | 'Unknown' — Type of SSL certificate based on validation level. DV (Domain Validation): Only domain ownership verified - easiest to obtain OV (Organization Validation): Organization identity verified EV (Extended Validation): Extensive organization verification - highest trust - `is_wildcard` boolean, nullable — Whether this is a wildcard certificate (*.example.com) - `key_size` integer, nullable — Public key size in bits - `tls_version` 'TLSv1.0' | 'TLSv1.1' | 'TLSv1.2' | 'TLSv1.3' | 'SSLv3' | 'Unknown' — TLS protocol version used for SSL connections. - `is_self_signed` boolean, nullable — Whether the certificate is self-signed (not trusted by a CA) - `is_revoked` boolean, nullable — Whether the certificate has been revoked (via OCSP check) - `website_structure_metrics` V1WebsiteStructureMetrics — Website structure metrics discovered during scraping. Formatted as strings for display: - depth: "0", "1", or "2+" - breadth: actual count as string or "15+" - `depth` string, required — Maximum depth reached: '0' (homepage only), '1' (one level), or '2+' (structured site) - `breadth` string, required — Total unique pages discovered: actual count or '15+' for substantial sites - `input_website_analysis` V1WebsiteAnalysisDetails - `id` string, uuid, required — The ID of the Website Analysis request - `url` string, uri, required — The website URL that was analyzed as part of the Search. - `redirects` V1WebsiteRedirectInfo - `is_redirect_url` boolean, required — Indicates that this website performs a cross-domain redirect. - `redirects_to` string, required — The domain this website redirects to. - `parked` boolean, nullable, required — A boolean indicating if the website is suspected of being a parked domain. - `email_deliverable` boolean, nullable — A boolean indicating if the website is able to send and receive emails. - `phone_numbers` string[], nullable — The list of phone numbers that were identified on the analyzed website. - `emails` string[], nullable, required — The list of email addresses that were identified on the analyzed website. - `social_profiles` V1SocialProfile[], nullable, required — The list of social media profiles that were identified on the analyzed website. - `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. - `url` string, required — The URL of the social profile. - `addresses` V1AddressSummaryResponse[] — The list of mailing addresses that were identified on the analyzed website. - `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. - `people` V1WebsiteAnalysisPerson[], nullable — The list of people identified on the analyzed website. - `name` string, required - `titles` string[], required - `website_build_status` 'coming_soon' | 'inactive' | 'active' - `website_summary` string, nullable — A summary of the business based on the analyzed website content. - `console_url` string, uri, required — The URL to the Website Analysis details in the console. - `screenshot_url` string, uri, nullable — The URL to download the homepage screenshot of the analyzed website. - `whois_record` V1WhoIsRecordResponse - `domain_created_at` string, date-time, nullable, required — The date and time when the domain was first registered. - `domain_age_months` integer, nullable — The age of the domain since its creation in months. - `domain_updated_at` string, date-time, nullable, required — The date and time when the domain registration was last updated. - `domain_expires_at` string, date-time, nullable, required — The date and time when the domain registration is set to expire. - `registrar` string, nullable, required — The name of the domain registrar. - `ssl_validity` V1SSLValidityInfo — SSL certificate information with fraud-relevant signals. is_valid semantics: True: Certificate is valid and trusted False: Certificate is definitively invalid (expired, untrusted, revoked, etc.) None: Cannot determine (connection failed, timeout, non-HTTPS) - `is_valid` boolean, nullable — Whether the SSL certificate is valid (True=valid, False=invalid, None=indeterminate) - `reason` 'CERTIFICATE_EXPIRED' | 'HOSTNAME_MISMATCH' | 'SELF_SIGNED' | 'REVOKED' | 'UNTRUSTED_AUTHORITY' | 'VERIFICATION_FAILED' | 'NOT_HTTPS' | 'CONNECTION_TIMED_OUT' | 'UNABLE_TO_CONNECT' | 'SERVER_DISCONNECTED' | 'SERVER_ERROR' | 'CONNECTION_ERROR' — Reasons why an SSL certificate check failed or could not be determined. Used when is_valid is False (certificate invalid) or None (indeterminate). - `issuer` string, nullable — Certificate issuer (CA) common name - `subject` string, nullable — Certificate subject common name - `issued_date` string, date-time, nullable — When the certificate was issued - `expiry_date` string, date-time, nullable — When the certificate expires - `days_until_expiry` integer, nullable — Days until certificate expires (negative if expired) - `cert_age_days` integer, nullable — Days since certificate was issued - `certificate_type` 'DV' | 'OV' | 'EV' | 'Unknown' — Type of SSL certificate based on validation level. DV (Domain Validation): Only domain ownership verified - easiest to obtain OV (Organization Validation): Organization identity verified EV (Extended Validation): Extensive organization verification - highest trust - `is_wildcard` boolean, nullable — Whether this is a wildcard certificate (*.example.com) - `key_size` integer, nullable — Public key size in bits - `tls_version` 'TLSv1.0' | 'TLSv1.1' | 'TLSv1.2' | 'TLSv1.3' | 'SSLv3' | 'Unknown' — TLS protocol version used for SSL connections. - `is_self_signed` boolean, nullable — Whether the certificate is self-signed (not trusted by a CA) - `is_revoked` boolean, nullable — Whether the certificate has been revoked (via OCSP check) - `website_structure_metrics` V1WebsiteStructureMetrics — Website structure metrics discovered during scraping. Formatted as strings for display: - depth: "0", "1", or "2+" - breadth: actual count as string or "15+" - `depth` string, required — Maximum depth reached: '0' (homepage only), '1' (one level), or '2+' (structured site) - `breadth` string, required — Total unique pages discovered: actual count or '15+' for substantial sites - `industry_prediction` V1PredictedNaicsResponse - `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. - `scores` V1ScoreResponse[], nullable — The scores associated with the web presence request, including WebKYB and WebRisk scores. - `type` 'fraud' | 'risk' | 'kyb', required - `score` number, required — The score value. - `rating` string, required — The rating associated with the score. - V1InternationalWebPresenceResponse - `request_type` 'INTERNATIONAL', required — The type of web presence request. - `id` string, uuid, required — The ID of the Web Presence request - `state` 'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required - `created_at` string, date-time, required — The date and time when the Web Presence request was created. - `updated_at` string, date-time, nullable — The most recent date and time when the Web Presence request was updated. - `options` string[] — The options for the web presence request. - `name` string, required — The name of the business as it was input for the search. - `alternative_names` string[], nullable — Alternative names for the business (e.g., DBA names) - `address` string, nullable — The address of the business as it was input for the search. - `iso2_country_code` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'XK' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' — Enumeration of ISO 3166-1 alpha-2 country codes. Attributes: (Various country codes like Andorra = "AD", etc.) - `website` string, nullable — The website of the business as it was input for the search. - `officer_names` string[], nullable — A list of business officers related to the business as they were input for the search. - `phone_number` string, nullable — The phone number as it was input for the search. - `email` string, nullable — The email as it was input for the search. - `reference_id` string, nullable — An optional reference ID associated with the web presence request. - `business_address_match` 'NO_MATCH' | 'REGION' | 'CITY' | 'COUNTRY' | 'EXACT' - `business_address_match_sources` V1WebPresenceSource[], nullable — The sources where the best address match was found. Only populated when business_address_match is not NoMatch. - `phone_number_match` 'NO_MATCH' | 'EXACT' | 'AREA_CODE' - `phone_number_match_sources` V1WebPresenceSource[], nullable — The sources where the best phone number match was found. Only populated when phone_number_match is not NoMatch. - `email_match` 'NO_MATCH' | 'EXACT' | 'DOMAIN' - `email_match_sources` V1WebPresenceSource[], nullable — The sources where the best email match was found. Only populated when email_match is not NoMatch. - `people_match` boolean, nullable — True if at least one officer name matches a person discovered during web presence analysis (exact or similar). Only populated when officer_names were provided in the request. - `people_match_sources` V1WebPresenceSource[], nullable — The sources where the people match was found. - `business_website_match` boolean, nullable — Indicates whether the inputted website matches the found business entity. - `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. - `found_website` string, nullable — The discovered website of the business. - `website_accuracy` number, nullable — The confidence score of the discovered website. - `found_social_profiles` V1DiscoveredSocialProfile[], nullable — A list of discovered social profiles related to the business. - `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. - … - V1DiscoveredLinkedInMetadata — LinkedIn-specific metadata extracted from a verified business profile. - … - V1DiscoveredFacebookMetadata — Facebook-specific metadata extracted from a verified business profile. - … - V1DiscoveredXMetadata — Twitter/X-specific metadata extracted from a verified business profile. - … - V1DiscoveredYouTubeMetadata — YouTube-specific metadata extracted from a verified business channel. - … - V1DiscoveredTikTokMetadata — TikTok-specific metadata extracted from a verified business profile. - … - V1DiscoveredPinterestMetadata — Pinterest-specific metadata extracted from a verified business 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. - `input_social_profiles` V1DiscoveredSocialProfile[], nullable — Scraped social profiles from user-provided inputs. - `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. - … - V1DiscoveredLinkedInMetadata — LinkedIn-specific metadata extracted from a verified business profile. - … - V1DiscoveredFacebookMetadata — Facebook-specific metadata extracted from a verified business profile. - … - V1DiscoveredXMetadata — Twitter/X-specific metadata extracted from a verified business profile. - … - V1DiscoveredYouTubeMetadata — YouTube-specific metadata extracted from a verified business channel. - … - V1DiscoveredTikTokMetadata — TikTok-specific metadata extracted from a verified business profile. - … - V1DiscoveredPinterestMetadata — Pinterest-specific metadata extracted from a verified business 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. - `social_profiles_match` V1InputSocialProfileMatch[], nullable — Match results for user-provided social profile inputs. Each entry echoes back the original input (site, value) and indicates whether it was also independently found during organic social discovery. - `site` 'linked_in:personal' | 'linked_in:company' | 'twitter' | 'instagram' | 'facebook' | 'youtube' | 'tiktok' | 'pinterest' | 'x', required — The social media platform from the original input. - `value` string, required — The username, handle, or URL from the original input. - `matched` boolean, required — Whether this input social profile was successfully scraped and verified during discovery. - `found_reviews` V1DiscoveredReview[], nullable — A list of discovered reviews related to the business. - `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). - `found_directory_listings` V1DiscoveredDirectoryListing[], nullable — A list of discovered directory listings related to the business. - `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 - `website_analysis` V1WebsiteAnalysisDetails - `id` string, uuid, required — The ID of the Website Analysis request - `url` string, uri, required — The website URL that was analyzed as part of the Search. - `redirects` V1WebsiteRedirectInfo - `is_redirect_url` boolean, required — Indicates that this website performs a cross-domain redirect. - `redirects_to` string, required — The domain this website redirects to. - `parked` boolean, nullable, required — A boolean indicating if the website is suspected of being a parked domain. - `email_deliverable` boolean, nullable — A boolean indicating if the website is able to send and receive emails. - `phone_numbers` string[], nullable — The list of phone numbers that were identified on the analyzed website. - `emails` string[], nullable, required — The list of email addresses that were identified on the analyzed website. - `social_profiles` V1SocialProfile[], nullable, required — The list of social media profiles that were identified on the analyzed website. - `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. - `url` string, required — The URL of the social profile. - `addresses` V1AddressSummaryResponse[] — The list of mailing addresses that were identified on the analyzed website. - `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. - `people` V1WebsiteAnalysisPerson[], nullable — The list of people identified on the analyzed website. - `name` string, required - `titles` string[], required - `website_build_status` 'coming_soon' | 'inactive' | 'active' - `website_summary` string, nullable — A summary of the business based on the analyzed website content. - `console_url` string, uri, required — The URL to the Website Analysis details in the console. - `screenshot_url` string, uri, nullable — The URL to download the homepage screenshot of the analyzed website. - `whois_record` V1WhoIsRecordResponse - `domain_created_at` string, date-time, nullable, required — The date and time when the domain was first registered. - `domain_age_months` integer, nullable — The age of the domain since its creation in months. - `domain_updated_at` string, date-time, nullable, required — The date and time when the domain registration was last updated. - `domain_expires_at` string, date-time, nullable, required — The date and time when the domain registration is set to expire. - `registrar` string, nullable, required — The name of the domain registrar. - `ssl_validity` V1SSLValidityInfo — SSL certificate information with fraud-relevant signals. is_valid semantics: True: Certificate is valid and trusted False: Certificate is definitively invalid (expired, untrusted, revoked, etc.) None: Cannot determine (connection failed, timeout, non-HTTPS) - `is_valid` boolean, nullable — Whether the SSL certificate is valid (True=valid, False=invalid, None=indeterminate) - `reason` 'CERTIFICATE_EXPIRED' | 'HOSTNAME_MISMATCH' | 'SELF_SIGNED' | 'REVOKED' | 'UNTRUSTED_AUTHORITY' | 'VERIFICATION_FAILED' | 'NOT_HTTPS' | 'CONNECTION_TIMED_OUT' | 'UNABLE_TO_CONNECT' | 'SERVER_DISCONNECTED' | 'SERVER_ERROR' | 'CONNECTION_ERROR' — Reasons why an SSL certificate check failed or could not be determined. Used when is_valid is False (certificate invalid) or None (indeterminate). - `issuer` string, nullable — Certificate issuer (CA) common name - `subject` string, nullable — Certificate subject common name - `issued_date` string, date-time, nullable — When the certificate was issued - `expiry_date` string, date-time, nullable — When the certificate expires - `days_until_expiry` integer, nullable — Days until certificate expires (negative if expired) - `cert_age_days` integer, nullable — Days since certificate was issued - `certificate_type` 'DV' | 'OV' | 'EV' | 'Unknown' — Type of SSL certificate based on validation level. DV (Domain Validation): Only domain ownership verified - easiest to obtain OV (Organization Validation): Organization identity verified EV (Extended Validation): Extensive organization verification - highest trust - `is_wildcard` boolean, nullable — Whether this is a wildcard certificate (*.example.com) - `key_size` integer, nullable — Public key size in bits - `tls_version` 'TLSv1.0' | 'TLSv1.1' | 'TLSv1.2' | 'TLSv1.3' | 'SSLv3' | 'Unknown' — TLS protocol version used for SSL connections. - `is_self_signed` boolean, nullable — Whether the certificate is self-signed (not trusted by a CA) - `is_revoked` boolean, nullable — Whether the certificate has been revoked (via OCSP check) - `website_structure_metrics` V1WebsiteStructureMetrics — Website structure metrics discovered during scraping. Formatted as strings for display: - depth: "0", "1", or "2+" - breadth: actual count as string or "15+" - `depth` string, required — Maximum depth reached: '0' (homepage only), '1' (one level), or '2+' (structured site) - `breadth` string, required — Total unique pages discovered: actual count or '15+' for substantial sites - `input_website_analysis` V1WebsiteAnalysisDetails - `id` string, uuid, required — The ID of the Website Analysis request - `url` string, uri, required — The website URL that was analyzed as part of the Search. - `redirects` V1WebsiteRedirectInfo - `is_redirect_url` boolean, required — Indicates that this website performs a cross-domain redirect. - `redirects_to` string, required — The domain this website redirects to. - `parked` boolean, nullable, required — A boolean indicating if the website is suspected of being a parked domain. - `email_deliverable` boolean, nullable — A boolean indicating if the website is able to send and receive emails. - `phone_numbers` string[], nullable — The list of phone numbers that were identified on the analyzed website. - `emails` string[], nullable, required — The list of email addresses that were identified on the analyzed website. - `social_profiles` V1SocialProfile[], nullable, required — The list of social media profiles that were identified on the analyzed website. - `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. - `url` string, required — The URL of the social profile. - `addresses` V1AddressSummaryResponse[] — The list of mailing addresses that were identified on the analyzed website. - `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. - `people` V1WebsiteAnalysisPerson[], nullable — The list of people identified on the analyzed website. - `name` string, required - `titles` string[], required - `website_build_status` 'coming_soon' | 'inactive' | 'active' - `website_summary` string, nullable — A summary of the business based on the analyzed website content. - `console_url` string, uri, required — The URL to the Website Analysis details in the console. - `screenshot_url` string, uri, nullable — The URL to download the homepage screenshot of the analyzed website. - `whois_record` V1WhoIsRecordResponse - `domain_created_at` string, date-time, nullable, required — The date and time when the domain was first registered. - `domain_age_months` integer, nullable — The age of the domain since its creation in months. - `domain_updated_at` string, date-time, nullable, required — The date and time when the domain registration was last updated. - `domain_expires_at` string, date-time, nullable, required — The date and time when the domain registration is set to expire. - `registrar` string, nullable, required — The name of the domain registrar. - `ssl_validity` V1SSLValidityInfo — SSL certificate information with fraud-relevant signals. is_valid semantics: True: Certificate is valid and trusted False: Certificate is definitively invalid (expired, untrusted, revoked, etc.) None: Cannot determine (connection failed, timeout, non-HTTPS) - `is_valid` boolean, nullable — Whether the SSL certificate is valid (True=valid, False=invalid, None=indeterminate) - `reason` 'CERTIFICATE_EXPIRED' | 'HOSTNAME_MISMATCH' | 'SELF_SIGNED' | 'REVOKED' | 'UNTRUSTED_AUTHORITY' | 'VERIFICATION_FAILED' | 'NOT_HTTPS' | 'CONNECTION_TIMED_OUT' | 'UNABLE_TO_CONNECT' | 'SERVER_DISCONNECTED' | 'SERVER_ERROR' | 'CONNECTION_ERROR' — Reasons why an SSL certificate check failed or could not be determined. Used when is_valid is False (certificate invalid) or None (indeterminate). - `issuer` string, nullable — Certificate issuer (CA) common name - `subject` string, nullable — Certificate subject common name - `issued_date` string, date-time, nullable — When the certificate was issued - `expiry_date` string, date-time, nullable — When the certificate expires - `days_until_expiry` integer, nullable — Days until certificate expires (negative if expired) - `cert_age_days` integer, nullable — Days since certificate was issued - `certificate_type` 'DV' | 'OV' | 'EV' | 'Unknown' — Type of SSL certificate based on validation level. DV (Domain Validation): Only domain ownership verified - easiest to obtain OV (Organization Validation): Organization identity verified EV (Extended Validation): Extensive organization verification - highest trust - `is_wildcard` boolean, nullable — Whether this is a wildcard certificate (*.example.com) - `key_size` integer, nullable — Public key size in bits - `tls_version` 'TLSv1.0' | 'TLSv1.1' | 'TLSv1.2' | 'TLSv1.3' | 'SSLv3' | 'Unknown' — TLS protocol version used for SSL connections. - `is_self_signed` boolean, nullable — Whether the certificate is self-signed (not trusted by a CA) - `is_revoked` boolean, nullable — Whether the certificate has been revoked (via OCSP check) - `website_structure_metrics` V1WebsiteStructureMetrics — Website structure metrics discovered during scraping. Formatted as strings for display: - depth: "0", "1", or "2+" - breadth: actual count as string or "15+" - `depth` string, required — Maximum depth reached: '0' (homepage only), '1' (one level), or '2+' (structured site) - `breadth` string, required — Total unique pages discovered: actual count or '15+' for substantial sites - `industry_prediction` V1PredictedNaicsResponse - `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. - `scores` V1ScoreResponse[], nullable — The scores associated with the web presence request, including WebKYB and WebRisk scores. - `type` 'fraud' | 'risk' | 'kyb', required - `score` number, required — The score value. - `rating` string, required — The rating associated with the score. - `__event__` V1WebhookMetadata - `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 - V2WebPresenceRequestSubmittedWebhook - `root` union, required — The webhook payload data - V2USWebPresenceResponse — US Web Presence Response with v2 fields. - `request_type` 'UNITED_STATES', required — The type of web presence request. - `id` string, uuid, required — The ID of the Web Presence request - `state` 'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required - `created_at` string, date-time, required — The date and time when the Web Presence request was created. - `updated_at` string, date-time, nullable — The most recent date and time when the Web Presence request was updated. - `options` string[] — The options for the web presence request. - `name` string, required — The name of the business as it was input for the search. - `alternative_names` string[], nullable — Alternative names for the business (e.g., DBA names) - `address` string, nullable — The address of the business as it was input for the search. - `iso2_country_code` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'XK' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' — Enumeration of ISO 3166-1 alpha-2 country codes. Attributes: (Various country codes like Andorra = "AD", etc.) - `website` string, nullable — The website of the business as it was input for the search. - `officer_names` string[], nullable — A list of business officers related to the business as they were input for the search. - `phone_number` string, nullable — The phone number as it was input for the search. - `email` string, nullable — The email as it was input for the search. - `reference_id` string, nullable — An optional reference ID associated with the web presence request. - `business_address_match` 'NO_MATCH' | 'CITY' | 'STATE' | 'SIMILAR' | 'EXACT' - `business_address_match_sources` V2WebPresenceSource[], nullable — The sources where the best address match was found. Only populated when business_address_match is not NoMatch. - `phone_number_match` 'NO_MATCH' | 'EXACT' | 'AREA_CODE' - `phone_number_match_sources` V2WebPresenceSource[], nullable — The sources where the best phone number match was found. Only populated when phone_number_match is not NoMatch. - `email_match` 'NO_MATCH' | 'EXACT' | 'DOMAIN' - `email_match_sources` V2WebPresenceSource[], nullable — The sources where the best email match was found. Only populated when email_match is not NoMatch. - `people_match` boolean, nullable — True if at least one officer name matches a person discovered during web presence analysis (exact or similar). Only populated when officer_names were provided in the request. - `people_match_sources` V2WebPresenceSource[], nullable — The sources where the people match was found. - `business_website_match` boolean, nullable — Indicates whether the inputted website matches the found business entity. - `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. - `found_website` string, nullable — The discovered website of the business. - `website_accuracy` number, nullable — The confidence score of the discovered website. - `found_social_profiles` V2DiscoveredSocialProfile[], nullable — A list of discovered social profiles related to the business. - `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. - V2DiscoveredInstagramMetadata — Instagram-specific metadata extracted from a verified business profile. - … - V2DiscoveredLinkedInMetadata — LinkedIn-specific metadata extracted from a verified business profile. - … - V2DiscoveredFacebookMetadata — Facebook-specific metadata extracted from a verified business profile. - … - V2DiscoveredXMetadata — Twitter/X-specific metadata extracted from a verified business profile. - … - V2DiscoveredYouTubeMetadata — YouTube-specific metadata extracted from a verified business channel. - … - V2DiscoveredTikTokMetadata — TikTok-specific metadata extracted from a verified business profile. - … - V2DiscoveredPinterestMetadata — Pinterest-specific metadata extracted from a verified business 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. - `input_social_profiles` V2DiscoveredSocialProfile[], nullable — Scraped social profiles from user-provided inputs. - `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. - V2DiscoveredInstagramMetadata — Instagram-specific metadata extracted from a verified business profile. - … - V2DiscoveredLinkedInMetadata — LinkedIn-specific metadata extracted from a verified business profile. - … - V2DiscoveredFacebookMetadata — Facebook-specific metadata extracted from a verified business profile. - … - V2DiscoveredXMetadata — Twitter/X-specific metadata extracted from a verified business profile. - … - V2DiscoveredYouTubeMetadata — YouTube-specific metadata extracted from a verified business channel. - … - V2DiscoveredTikTokMetadata — TikTok-specific metadata extracted from a verified business profile. - … - V2DiscoveredPinterestMetadata — Pinterest-specific metadata extracted from a verified business 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. - `social_profiles_match` V2InputSocialProfileMatch[], nullable — Match results for user-provided social profile inputs. Each entry echoes back the original input (site, value) and indicates whether it was also independently found during organic social discovery. - `site` 'linked_in:personal' | 'linked_in:company' | 'twitter' | 'instagram' | 'facebook' | 'youtube' | 'tiktok' | 'pinterest' | 'x', required — The social media platform from the original input. - `value` string, required — The username, handle, or URL from the original input. - `matched` boolean, required — Whether this input social profile was successfully scraped and verified during discovery. - `found_reviews` V2DiscoveredReview[], nullable — A list of discovered reviews related to the business. - `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` V2ReviewDetail[] — 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` V2GoogleReviewMetadata — 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). - `found_directory_listings` V2DiscoveredDirectoryListing[], nullable — A list of discovered directory listings related to the business. - `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` V2DirectoryListingPerson[] — Officers, principals, or key people listed on the directory page. - `name` string, required - `title` string, nullable - `website_analysis` V2WebsiteAnalysisDetails - `id` string, uuid, required — The ID of the Website Analysis request - `url` string, uri, required — The website URL that was analyzed as part of the Search. - `redirects` V2WebsiteRedirectInfo - `is_redirect_url` boolean, required — Indicates that this website performs a cross-domain redirect. - `redirects_to` string, required — The domain this website redirects to. - `parked` boolean, nullable, required — A boolean indicating if the website is suspected of being a parked domain. - `email_deliverable` boolean, nullable — A boolean indicating if the website is able to send and receive emails. - `phone_numbers` string[], nullable — The list of phone numbers that were identified on the analyzed website. - `emails` string[], nullable, required — The list of email addresses that were identified on the analyzed website. - `social_profiles` V2SocialProfile[], nullable, required — The list of social media profiles that were identified on the analyzed website. - `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. - `url` string, required — The URL of the social profile. - `addresses` V2AddressSummaryResponse[] — The list of mailing addresses that were identified on the analyzed website. - `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. - `people` V2WebsiteAnalysisPerson[], nullable — The list of people identified on the analyzed website. - `name` string, required - `titles` string[], required - `website_build_status` 'coming_soon' | 'inactive' | 'active' - `website_summary` string, nullable — A summary of the business based on the analyzed website content. - `console_url` string, uri, required — The URL to the Website Analysis details in the console. - `screenshot_url` string, uri, nullable — The URL to download the homepage screenshot of the analyzed website. - `whois_record` V2WhoIsRecordResponse - `domain_created_at` string, date-time, nullable, required — The date and time when the domain was first registered. - `domain_age_months` integer, nullable — The age of the domain since its creation in months. - `domain_updated_at` string, date-time, nullable, required — The date and time when the domain registration was last updated. - `domain_expires_at` string, date-time, nullable, required — The date and time when the domain registration is set to expire. - `registrar` string, nullable, required — The name of the domain registrar. - `ssl_validity` V2SSLValidityInfo — SSL certificate information with fraud-relevant signals. is_valid semantics: True: Certificate is valid and trusted False: Certificate is definitively invalid (expired, untrusted, revoked, etc.) None: Cannot determine (connection failed, timeout, non-HTTPS) - `is_valid` boolean, nullable — Whether the SSL certificate is valid (True=valid, False=invalid, None=indeterminate) - `reason` 'CERTIFICATE_EXPIRED' | 'HOSTNAME_MISMATCH' | 'SELF_SIGNED' | 'REVOKED' | 'UNTRUSTED_AUTHORITY' | 'VERIFICATION_FAILED' | 'NOT_HTTPS' | 'CONNECTION_TIMED_OUT' | 'UNABLE_TO_CONNECT' | 'SERVER_DISCONNECTED' | 'SERVER_ERROR' | 'CONNECTION_ERROR' — Reasons why an SSL certificate check failed or could not be determined. Used when is_valid is False (certificate invalid) or None (indeterminate). - `issuer` string, nullable — Certificate issuer (CA) common name - `subject` string, nullable — Certificate subject common name - `issued_date` string, date-time, nullable — When the certificate was issued - `expiry_date` string, date-time, nullable — When the certificate expires - `days_until_expiry` integer, nullable — Days until certificate expires (negative if expired) - `cert_age_days` integer, nullable — Days since certificate was issued - `certificate_type` 'DV' | 'OV' | 'EV' | 'Unknown' — Type of SSL certificate based on validation level. DV (Domain Validation): Only domain ownership verified - easiest to obtain OV (Organization Validation): Organization identity verified EV (Extended Validation): Extensive organization verification - highest trust - `is_wildcard` boolean, nullable — Whether this is a wildcard certificate (*.example.com) - `key_size` integer, nullable — Public key size in bits - `tls_version` 'TLSv1.0' | 'TLSv1.1' | 'TLSv1.2' | 'TLSv1.3' | 'SSLv3' | 'Unknown' — TLS protocol version used for SSL connections. - `is_self_signed` boolean, nullable — Whether the certificate is self-signed (not trusted by a CA) - `is_revoked` boolean, nullable — Whether the certificate has been revoked (via OCSP check) - `website_structure_metrics` V2WebsiteStructureMetrics — Website structure metrics discovered during scraping. Formatted as strings for display: - depth: "0", "1", or "2+" - breadth: actual count as string or "15+" - `depth` string, required — Maximum depth reached: '0' (homepage only), '1' (one level), or '2+' (structured site) - `breadth` string, required — Total unique pages discovered: actual count or '15+' for substantial sites - `input_website_analysis` V2WebsiteAnalysisDetails - `id` string, uuid, required — The ID of the Website Analysis request - `url` string, uri, required — The website URL that was analyzed as part of the Search. - `redirects` V2WebsiteRedirectInfo - `is_redirect_url` boolean, required — Indicates that this website performs a cross-domain redirect. - `redirects_to` string, required — The domain this website redirects to. - `parked` boolean, nullable, required — A boolean indicating if the website is suspected of being a parked domain. - `email_deliverable` boolean, nullable — A boolean indicating if the website is able to send and receive emails. - `phone_numbers` string[], nullable — The list of phone numbers that were identified on the analyzed website. - `emails` string[], nullable, required — The list of email addresses that were identified on the analyzed website. - `social_profiles` V2SocialProfile[], nullable, required — The list of social media profiles that were identified on the analyzed website. - `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. - `url` string, required — The URL of the social profile. - `addresses` V2AddressSummaryResponse[] — The list of mailing addresses that were identified on the analyzed website. - `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. - `people` V2WebsiteAnalysisPerson[], nullable — The list of people identified on the analyzed website. - `name` string, required - `titles` string[], required - `website_build_status` 'coming_soon' | 'inactive' | 'active' - `website_summary` string, nullable — A summary of the business based on the analyzed website content. - `console_url` string, uri, required — The URL to the Website Analysis details in the console. - `screenshot_url` string, uri, nullable — The URL to download the homepage screenshot of the analyzed website. - `whois_record` V2WhoIsRecordResponse - `domain_created_at` string, date-time, nullable, required — The date and time when the domain was first registered. - `domain_age_months` integer, nullable — The age of the domain since its creation in months. - `domain_updated_at` string, date-time, nullable, required — The date and time when the domain registration was last updated. - `domain_expires_at` string, date-time, nullable, required — The date and time when the domain registration is set to expire. - `registrar` string, nullable, required — The name of the domain registrar. - `ssl_validity` V2SSLValidityInfo — SSL certificate information with fraud-relevant signals. is_valid semantics: True: Certificate is valid and trusted False: Certificate is definitively invalid (expired, untrusted, revoked, etc.) None: Cannot determine (connection failed, timeout, non-HTTPS) - `is_valid` boolean, nullable — Whether the SSL certificate is valid (True=valid, False=invalid, None=indeterminate) - `reason` 'CERTIFICATE_EXPIRED' | 'HOSTNAME_MISMATCH' | 'SELF_SIGNED' | 'REVOKED' | 'UNTRUSTED_AUTHORITY' | 'VERIFICATION_FAILED' | 'NOT_HTTPS' | 'CONNECTION_TIMED_OUT' | 'UNABLE_TO_CONNECT' | 'SERVER_DISCONNECTED' | 'SERVER_ERROR' | 'CONNECTION_ERROR' — Reasons why an SSL certificate check failed or could not be determined. Used when is_valid is False (certificate invalid) or None (indeterminate). - `issuer` string, nullable — Certificate issuer (CA) common name - `subject` string, nullable — Certificate subject common name - `issued_date` string, date-time, nullable — When the certificate was issued - `expiry_date` string, date-time, nullable — When the certificate expires - `days_until_expiry` integer, nullable — Days until certificate expires (negative if expired) - `cert_age_days` integer, nullable — Days since certificate was issued - `certificate_type` 'DV' | 'OV' | 'EV' | 'Unknown' — Type of SSL certificate based on validation level. DV (Domain Validation): Only domain ownership verified - easiest to obtain OV (Organization Validation): Organization identity verified EV (Extended Validation): Extensive organization verification - highest trust - `is_wildcard` boolean, nullable — Whether this is a wildcard certificate (*.example.com) - `key_size` integer, nullable — Public key size in bits - `tls_version` 'TLSv1.0' | 'TLSv1.1' | 'TLSv1.2' | 'TLSv1.3' | 'SSLv3' | 'Unknown' — TLS protocol version used for SSL connections. - `is_self_signed` boolean, nullable — Whether the certificate is self-signed (not trusted by a CA) - `is_revoked` boolean, nullable — Whether the certificate has been revoked (via OCSP check) - `website_structure_metrics` V2WebsiteStructureMetrics — Website structure metrics discovered during scraping. Formatted as strings for display: - depth: "0", "1", or "2+" - breadth: actual count as string or "15+" - `depth` string, required — Maximum depth reached: '0' (homepage only), '1' (one level), or '2+' (structured site) - `breadth` string, required — Total unique pages discovered: actual count or '15+' for substantial sites - `industry_prediction` V2PredictedNaicsResponse - `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` V2MCC[], 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` V2SICCode[], 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. - `scores` V2ScoreResponse[], nullable — The scores associated with the web presence request, including WebKYB and WebRisk scores. - `type` 'fraud' | 'risk' | 'kyb', required - `score` number, required — The score value. - `rating` string, required — The rating associated with the score. - `discovered_website_analysis` V2WebsiteAnalysisDetails - `id` string, uuid, required — The ID of the Website Analysis request - `url` string, uri, required — The website URL that was analyzed as part of the Search. - `redirects` V2WebsiteRedirectInfo - `is_redirect_url` boolean, required — Indicates that this website performs a cross-domain redirect. - `redirects_to` string, required — The domain this website redirects to. - `parked` boolean, nullable, required — A boolean indicating if the website is suspected of being a parked domain. - `email_deliverable` boolean, nullable — A boolean indicating if the website is able to send and receive emails. - `phone_numbers` string[], nullable — The list of phone numbers that were identified on the analyzed website. - `emails` string[], nullable, required — The list of email addresses that were identified on the analyzed website. - `social_profiles` V2SocialProfile[], nullable, required — The list of social media profiles that were identified on the analyzed website. - `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. - `url` string, required — The URL of the social profile. - `addresses` V2AddressSummaryResponse[] — The list of mailing addresses that were identified on the analyzed website. - `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. - `people` V2WebsiteAnalysisPerson[], nullable — The list of people identified on the analyzed website. - `name` string, required - `titles` string[], required - `website_build_status` 'coming_soon' | 'inactive' | 'active' - `website_summary` string, nullable — A summary of the business based on the analyzed website content. - `console_url` string, uri, required — The URL to the Website Analysis details in the console. - `screenshot_url` string, uri, nullable — The URL to download the homepage screenshot of the analyzed website. - `whois_record` V2WhoIsRecordResponse - `domain_created_at` string, date-time, nullable, required — The date and time when the domain was first registered. - `domain_age_months` integer, nullable — The age of the domain since its creation in months. - `domain_updated_at` string, date-time, nullable, required — The date and time when the domain registration was last updated. - `domain_expires_at` string, date-time, nullable, required — The date and time when the domain registration is set to expire. - `registrar` string, nullable, required — The name of the domain registrar. - `ssl_validity` V2SSLValidityInfo — SSL certificate information with fraud-relevant signals. is_valid semantics: True: Certificate is valid and trusted False: Certificate is definitively invalid (expired, untrusted, revoked, etc.) None: Cannot determine (connection failed, timeout, non-HTTPS) - `is_valid` boolean, nullable — Whether the SSL certificate is valid (True=valid, False=invalid, None=indeterminate) - `reason` 'CERTIFICATE_EXPIRED' | 'HOSTNAME_MISMATCH' | 'SELF_SIGNED' | 'REVOKED' | 'UNTRUSTED_AUTHORITY' | 'VERIFICATION_FAILED' | 'NOT_HTTPS' | 'CONNECTION_TIMED_OUT' | 'UNABLE_TO_CONNECT' | 'SERVER_DISCONNECTED' | 'SERVER_ERROR' | 'CONNECTION_ERROR' — Reasons why an SSL certificate check failed or could not be determined. Used when is_valid is False (certificate invalid) or None (indeterminate). - `issuer` string, nullable — Certificate issuer (CA) common name - `subject` string, nullable — Certificate subject common name - `issued_date` string, date-time, nullable — When the certificate was issued - `expiry_date` string, date-time, nullable — When the certificate expires - `days_until_expiry` integer, nullable — Days until certificate expires (negative if expired) - `cert_age_days` integer, nullable — Days since certificate was issued - `certificate_type` 'DV' | 'OV' | 'EV' | 'Unknown' — Type of SSL certificate based on validation level. DV (Domain Validation): Only domain ownership verified - easiest to obtain OV (Organization Validation): Organization identity verified EV (Extended Validation): Extensive organization verification - highest trust - `is_wildcard` boolean, nullable — Whether this is a wildcard certificate (*.example.com) - `key_size` integer, nullable — Public key size in bits - `tls_version` 'TLSv1.0' | 'TLSv1.1' | 'TLSv1.2' | 'TLSv1.3' | 'SSLv3' | 'Unknown' — TLS protocol version used for SSL connections. - `is_self_signed` boolean, nullable — Whether the certificate is self-signed (not trusted by a CA) - `is_revoked` boolean, nullable — Whether the certificate has been revoked (via OCSP check) - `website_structure_metrics` V2WebsiteStructureMetrics — Website structure metrics discovered during scraping. Formatted as strings for display: - depth: "0", "1", or "2+" - breadth: actual count as string or "15+" - `depth` string, required — Maximum depth reached: '0' (homepage only), '1' (one level), or '2+' (structured site) - `breadth` string, required — Total unique pages discovered: actual count or '15+' for substantial sites - V2InternationalWebPresenceResponse — International Web Presence Response with v2 fields. - `request_type` 'INTERNATIONAL', required — The type of web presence request. - `id` string, uuid, required — The ID of the Web Presence request - `state` 'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required - `created_at` string, date-time, required — The date and time when the Web Presence request was created. - `updated_at` string, date-time, nullable — The most recent date and time when the Web Presence request was updated. - `options` string[] — The options for the web presence request. - `name` string, required — The name of the business as it was input for the search. - `alternative_names` string[], nullable — Alternative names for the business (e.g., DBA names) - `address` string, nullable — The address of the business as it was input for the search. - `iso2_country_code` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'XK' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' — Enumeration of ISO 3166-1 alpha-2 country codes. Attributes: (Various country codes like Andorra = "AD", etc.) - `website` string, nullable — The website of the business as it was input for the search. - `officer_names` string[], nullable — A list of business officers related to the business as they were input for the search. - `phone_number` string, nullable — The phone number as it was input for the search. - `email` string, nullable — The email as it was input for the search. - `reference_id` string, nullable — An optional reference ID associated with the web presence request. - `business_address_match` 'NO_MATCH' | 'REGION' | 'CITY' | 'COUNTRY' | 'EXACT' - `business_address_match_sources` V2WebPresenceSource[], nullable — The sources where the best address match was found. Only populated when business_address_match is not NoMatch. - `phone_number_match` 'NO_MATCH' | 'EXACT' | 'AREA_CODE' - `phone_number_match_sources` V2WebPresenceSource[], nullable — The sources where the best phone number match was found. Only populated when phone_number_match is not NoMatch. - `email_match` 'NO_MATCH' | 'EXACT' | 'DOMAIN' - `email_match_sources` V2WebPresenceSource[], nullable — The sources where the best email match was found. Only populated when email_match is not NoMatch. - `people_match` boolean, nullable — True if at least one officer name matches a person discovered during web presence analysis (exact or similar). Only populated when officer_names were provided in the request. - `people_match_sources` V2WebPresenceSource[], nullable — The sources where the people match was found. - `business_website_match` boolean, nullable — Indicates whether the inputted website matches the found business entity. - `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. - `found_website` string, nullable — The discovered website of the business. - `website_accuracy` number, nullable — The confidence score of the discovered website. - `found_social_profiles` V2DiscoveredSocialProfile[], nullable — A list of discovered social profiles related to the business. - `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. - V2DiscoveredInstagramMetadata — Instagram-specific metadata extracted from a verified business profile. - … - V2DiscoveredLinkedInMetadata — LinkedIn-specific metadata extracted from a verified business profile. - … - V2DiscoveredFacebookMetadata — Facebook-specific metadata extracted from a verified business profile. - … - V2DiscoveredXMetadata — Twitter/X-specific metadata extracted from a verified business profile. - … - V2DiscoveredYouTubeMetadata — YouTube-specific metadata extracted from a verified business channel. - … - V2DiscoveredTikTokMetadata — TikTok-specific metadata extracted from a verified business profile. - … - V2DiscoveredPinterestMetadata — Pinterest-specific metadata extracted from a verified business 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. - `input_social_profiles` V2DiscoveredSocialProfile[], nullable — Scraped social profiles from user-provided inputs. - `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. - V2DiscoveredInstagramMetadata — Instagram-specific metadata extracted from a verified business profile. - … - V2DiscoveredLinkedInMetadata — LinkedIn-specific metadata extracted from a verified business profile. - … - V2DiscoveredFacebookMetadata — Facebook-specific metadata extracted from a verified business profile. - … - V2DiscoveredXMetadata — Twitter/X-specific metadata extracted from a verified business profile. - … - V2DiscoveredYouTubeMetadata — YouTube-specific metadata extracted from a verified business channel. - … - V2DiscoveredTikTokMetadata — TikTok-specific metadata extracted from a verified business profile. - … - V2DiscoveredPinterestMetadata — Pinterest-specific metadata extracted from a verified business 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. - `social_profiles_match` V2InputSocialProfileMatch[], nullable — Match results for user-provided social profile inputs. Each entry echoes back the original input (site, value) and indicates whether it was also independently found during organic social discovery. - `site` 'linked_in:personal' | 'linked_in:company' | 'twitter' | 'instagram' | 'facebook' | 'youtube' | 'tiktok' | 'pinterest' | 'x', required — The social media platform from the original input. - `value` string, required — The username, handle, or URL from the original input. - `matched` boolean, required — Whether this input social profile was successfully scraped and verified during discovery. - `found_reviews` V2DiscoveredReview[], nullable — A list of discovered reviews related to the business. - `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` V2ReviewDetail[] — 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` V2GoogleReviewMetadata — 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). - `found_directory_listings` V2DiscoveredDirectoryListing[], nullable — A list of discovered directory listings related to the business. - `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` V2DirectoryListingPerson[] — Officers, principals, or key people listed on the directory page. - `name` string, required - `title` string, nullable - `website_analysis` V2WebsiteAnalysisDetails - `id` string, uuid, required — The ID of the Website Analysis request - `url` string, uri, required — The website URL that was analyzed as part of the Search. - `redirects` V2WebsiteRedirectInfo - `is_redirect_url` boolean, required — Indicates that this website performs a cross-domain redirect. - `redirects_to` string, required — The domain this website redirects to. - `parked` boolean, nullable, required — A boolean indicating if the website is suspected of being a parked domain. - `email_deliverable` boolean, nullable — A boolean indicating if the website is able to send and receive emails. - `phone_numbers` string[], nullable — The list of phone numbers that were identified on the analyzed website. - `emails` string[], nullable, required — The list of email addresses that were identified on the analyzed website. - `social_profiles` V2SocialProfile[], nullable, required — The list of social media profiles that were identified on the analyzed website. - `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. - `url` string, required — The URL of the social profile. - `addresses` V2AddressSummaryResponse[] — The list of mailing addresses that were identified on the analyzed website. - `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. - `people` V2WebsiteAnalysisPerson[], nullable — The list of people identified on the analyzed website. - `name` string, required - `titles` string[], required - `website_build_status` 'coming_soon' | 'inactive' | 'active' - `website_summary` string, nullable — A summary of the business based on the analyzed website content. - `console_url` string, uri, required — The URL to the Website Analysis details in the console. - `screenshot_url` string, uri, nullable — The URL to download the homepage screenshot of the analyzed website. - `whois_record` V2WhoIsRecordResponse - `domain_created_at` string, date-time, nullable, required — The date and time when the domain was first registered. - `domain_age_months` integer, nullable — The age of the domain since its creation in months. - `domain_updated_at` string, date-time, nullable, required — The date and time when the domain registration was last updated. - `domain_expires_at` string, date-time, nullable, required — The date and time when the domain registration is set to expire. - `registrar` string, nullable, required — The name of the domain registrar. - `ssl_validity` V2SSLValidityInfo — SSL certificate information with fraud-relevant signals. is_valid semantics: True: Certificate is valid and trusted False: Certificate is definitively invalid (expired, untrusted, revoked, etc.) None: Cannot determine (connection failed, timeout, non-HTTPS) - `is_valid` boolean, nullable — Whether the SSL certificate is valid (True=valid, False=invalid, None=indeterminate) - `reason` 'CERTIFICATE_EXPIRED' | 'HOSTNAME_MISMATCH' | 'SELF_SIGNED' | 'REVOKED' | 'UNTRUSTED_AUTHORITY' | 'VERIFICATION_FAILED' | 'NOT_HTTPS' | 'CONNECTION_TIMED_OUT' | 'UNABLE_TO_CONNECT' | 'SERVER_DISCONNECTED' | 'SERVER_ERROR' | 'CONNECTION_ERROR' — Reasons why an SSL certificate check failed or could not be determined. Used when is_valid is False (certificate invalid) or None (indeterminate). - `issuer` string, nullable — Certificate issuer (CA) common name - `subject` string, nullable — Certificate subject common name - `issued_date` string, date-time, nullable — When the certificate was issued - `expiry_date` string, date-time, nullable — When the certificate expires - `days_until_expiry` integer, nullable — Days until certificate expires (negative if expired) - `cert_age_days` integer, nullable — Days since certificate was issued - `certificate_type` 'DV' | 'OV' | 'EV' | 'Unknown' — Type of SSL certificate based on validation level. DV (Domain Validation): Only domain ownership verified - easiest to obtain OV (Organization Validation): Organization identity verified EV (Extended Validation): Extensive organization verification - highest trust - `is_wildcard` boolean, nullable — Whether this is a wildcard certificate (*.example.com) - `key_size` integer, nullable — Public key size in bits - `tls_version` 'TLSv1.0' | 'TLSv1.1' | 'TLSv1.2' | 'TLSv1.3' | 'SSLv3' | 'Unknown' — TLS protocol version used for SSL connections. - `is_self_signed` boolean, nullable — Whether the certificate is self-signed (not trusted by a CA) - `is_revoked` boolean, nullable — Whether the certificate has been revoked (via OCSP check) - `website_structure_metrics` V2WebsiteStructureMetrics — Website structure metrics discovered during scraping. Formatted as strings for display: - depth: "0", "1", or "2+" - breadth: actual count as string or "15+" - `depth` string, required — Maximum depth reached: '0' (homepage only), '1' (one level), or '2+' (structured site) - `breadth` string, required — Total unique pages discovered: actual count or '15+' for substantial sites - `input_website_analysis` V2WebsiteAnalysisDetails - `id` string, uuid, required — The ID of the Website Analysis request - `url` string, uri, required — The website URL that was analyzed as part of the Search. - `redirects` V2WebsiteRedirectInfo - `is_redirect_url` boolean, required — Indicates that this website performs a cross-domain redirect. - `redirects_to` string, required — The domain this website redirects to. - `parked` boolean, nullable, required — A boolean indicating if the website is suspected of being a parked domain. - `email_deliverable` boolean, nullable — A boolean indicating if the website is able to send and receive emails. - `phone_numbers` string[], nullable — The list of phone numbers that were identified on the analyzed website. - `emails` string[], nullable, required — The list of email addresses that were identified on the analyzed website. - `social_profiles` V2SocialProfile[], nullable, required — The list of social media profiles that were identified on the analyzed website. - `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. - `url` string, required — The URL of the social profile. - `addresses` V2AddressSummaryResponse[] — The list of mailing addresses that were identified on the analyzed website. - `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. - `people` V2WebsiteAnalysisPerson[], nullable — The list of people identified on the analyzed website. - `name` string, required - `titles` string[], required - `website_build_status` 'coming_soon' | 'inactive' | 'active' - `website_summary` string, nullable — A summary of the business based on the analyzed website content. - `console_url` string, uri, required — The URL to the Website Analysis details in the console. - `screenshot_url` string, uri, nullable — The URL to download the homepage screenshot of the analyzed website. - `whois_record` V2WhoIsRecordResponse - `domain_created_at` string, date-time, nullable, required — The date and time when the domain was first registered. - `domain_age_months` integer, nullable — The age of the domain since its creation in months. - `domain_updated_at` string, date-time, nullable, required — The date and time when the domain registration was last updated. - `domain_expires_at` string, date-time, nullable, required — The date and time when the domain registration is set to expire. - `registrar` string, nullable, required — The name of the domain registrar. - `ssl_validity` V2SSLValidityInfo — SSL certificate information with fraud-relevant signals. is_valid semantics: True: Certificate is valid and trusted False: Certificate is definitively invalid (expired, untrusted, revoked, etc.) None: Cannot determine (connection failed, timeout, non-HTTPS) - `is_valid` boolean, nullable — Whether the SSL certificate is valid (True=valid, False=invalid, None=indeterminate) - `reason` 'CERTIFICATE_EXPIRED' | 'HOSTNAME_MISMATCH' | 'SELF_SIGNED' | 'REVOKED' | 'UNTRUSTED_AUTHORITY' | 'VERIFICATION_FAILED' | 'NOT_HTTPS' | 'CONNECTION_TIMED_OUT' | 'UNABLE_TO_CONNECT' | 'SERVER_DISCONNECTED' | 'SERVER_ERROR' | 'CONNECTION_ERROR' — Reasons why an SSL certificate check failed or could not be determined. Used when is_valid is False (certificate invalid) or None (indeterminate). - `issuer` string, nullable — Certificate issuer (CA) common name - `subject` string, nullable — Certificate subject common name - `issued_date` string, date-time, nullable — When the certificate was issued - `expiry_date` string, date-time, nullable — When the certificate expires - `days_until_expiry` integer, nullable — Days until certificate expires (negative if expired) - `cert_age_days` integer, nullable — Days since certificate was issued - `certificate_type` 'DV' | 'OV' | 'EV' | 'Unknown' — Type of SSL certificate based on validation level. DV (Domain Validation): Only domain ownership verified - easiest to obtain OV (Organization Validation): Organization identity verified EV (Extended Validation): Extensive organization verification - highest trust - `is_wildcard` boolean, nullable — Whether this is a wildcard certificate (*.example.com) - `key_size` integer, nullable — Public key size in bits - `tls_version` 'TLSv1.0' | 'TLSv1.1' | 'TLSv1.2' | 'TLSv1.3' | 'SSLv3' | 'Unknown' — TLS protocol version used for SSL connections. - `is_self_signed` boolean, nullable — Whether the certificate is self-signed (not trusted by a CA) - `is_revoked` boolean, nullable — Whether the certificate has been revoked (via OCSP check) - `website_structure_metrics` V2WebsiteStructureMetrics — Website structure metrics discovered during scraping. Formatted as strings for display: - depth: "0", "1", or "2+" - breadth: actual count as string or "15+" - `depth` string, required — Maximum depth reached: '0' (homepage only), '1' (one level), or '2+' (structured site) - `breadth` string, required — Total unique pages discovered: actual count or '15+' for substantial sites - `industry_prediction` V2PredictedNaicsResponse - `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` V2MCC[], 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` V2SICCode[], 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. - `scores` V2ScoreResponse[], nullable — The scores associated with the web presence request, including WebKYB and WebRisk scores. - `type` 'fraud' | 'risk' | 'kyb', required - `score` number, required — The score value. - `rating` string, required — The rating associated with the score. - `discovered_website_analysis` V2WebsiteAnalysisDetails - `id` string, uuid, required — The ID of the Website Analysis request - `url` string, uri, required — The website URL that was analyzed as part of the Search. - `redirects` V2WebsiteRedirectInfo - `is_redirect_url` boolean, required — Indicates that this website performs a cross-domain redirect. - `redirects_to` string, required — The domain this website redirects to. - `parked` boolean, nullable, required — A boolean indicating if the website is suspected of being a parked domain. - `email_deliverable` boolean, nullable — A boolean indicating if the website is able to send and receive emails. - `phone_numbers` string[], nullable — The list of phone numbers that were identified on the analyzed website. - `emails` string[], nullable, required — The list of email addresses that were identified on the analyzed website. - `social_profiles` V2SocialProfile[], nullable, required — The list of social media profiles that were identified on the analyzed website. - `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. - `url` string, required — The URL of the social profile. - `addresses` V2AddressSummaryResponse[] — The list of mailing addresses that were identified on the analyzed website. - `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. - `people` V2WebsiteAnalysisPerson[], nullable — The list of people identified on the analyzed website. - `name` string, required - `titles` string[], required - `website_build_status` 'coming_soon' | 'inactive' | 'active' - `website_summary` string, nullable — A summary of the business based on the analyzed website content. - `console_url` string, uri, required — The URL to the Website Analysis details in the console. - `screenshot_url` string, uri, nullable — The URL to download the homepage screenshot of the analyzed website. - `whois_record` V2WhoIsRecordResponse - `domain_created_at` string, date-time, nullable, required — The date and time when the domain was first registered. - `domain_age_months` integer, nullable — The age of the domain since its creation in months. - `domain_updated_at` string, date-time, nullable, required — The date and time when the domain registration was last updated. - `domain_expires_at` string, date-time, nullable, required — The date and time when the domain registration is set to expire. - `registrar` string, nullable, required — The name of the domain registrar. - `ssl_validity` V2SSLValidityInfo — SSL certificate information with fraud-relevant signals. is_valid semantics: True: Certificate is valid and trusted False: Certificate is definitively invalid (expired, untrusted, revoked, etc.) None: Cannot determine (connection failed, timeout, non-HTTPS) - `is_valid` boolean, nullable — Whether the SSL certificate is valid (True=valid, False=invalid, None=indeterminate) - `reason` 'CERTIFICATE_EXPIRED' | 'HOSTNAME_MISMATCH' | 'SELF_SIGNED' | 'REVOKED' | 'UNTRUSTED_AUTHORITY' | 'VERIFICATION_FAILED' | 'NOT_HTTPS' | 'CONNECTION_TIMED_OUT' | 'UNABLE_TO_CONNECT' | 'SERVER_DISCONNECTED' | 'SERVER_ERROR' | 'CONNECTION_ERROR' — Reasons why an SSL certificate check failed or could not be determined. Used when is_valid is False (certificate invalid) or None (indeterminate). - `issuer` string, nullable — Certificate issuer (CA) common name - `subject` string, nullable — Certificate subject common name - `issued_date` string, date-time, nullable — When the certificate was issued - `expiry_date` string, date-time, nullable — When the certificate expires - `days_until_expiry` integer, nullable — Days until certificate expires (negative if expired) - `cert_age_days` integer, nullable — Days since certificate was issued - `certificate_type` 'DV' | 'OV' | 'EV' | 'Unknown' — Type of SSL certificate based on validation level. DV (Domain Validation): Only domain ownership verified - easiest to obtain OV (Organization Validation): Organization identity verified EV (Extended Validation): Extensive organization verification - highest trust - `is_wildcard` boolean, nullable — Whether this is a wildcard certificate (*.example.com) - `key_size` integer, nullable — Public key size in bits - `tls_version` 'TLSv1.0' | 'TLSv1.1' | 'TLSv1.2' | 'TLSv1.3' | 'SSLv3' | 'Unknown' — TLS protocol version used for SSL connections. - `is_self_signed` boolean, nullable — Whether the certificate is self-signed (not trusted by a CA) - `is_revoked` boolean, nullable — Whether the certificate has been revoked (via OCSP check) - `website_structure_metrics` V2WebsiteStructureMetrics — Website structure metrics discovered during scraping. Formatted as strings for display: - depth: "0", "1", or "2+" - breadth: actual count as string or "15+" - `depth` string, required — Maximum depth reached: '0' (homepage only), '1' (one level), or '2+' (structured site) - `breadth` string, required — Total unique pages discovered: actual count or '15+' for substantial sites - `__event__` V2WebhookMetadata - `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 ## 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/revisions/0cc89938bc26/schema)