--- title: "Get Verification" method: GET path: "/v2/partners/{partner_id}/kyb/{verification_id}" tags: ["kyb"] --- # Get Verification `GET /v2/partners/{partner_id}/kyb/{verification_id}` ## Request - Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from) - URL: `https://api.stuut.ai/v2/partners/{partner_id}/kyb/{verification_id}` - Auth: HTTP bearer Get KYB Verification Detail Returns detailed verification results including officers, liens, and watchlist hits. ## Path parameters - `partner_id` string, required - `verification_id` string, required ## Response `200` Successful Response - KYBVerificationDetail: Full KYB verification details. - `created_at` string, date-time, required - `modified_at` string, date-time, nullable, required - `id` string, required - `status` 'pending' | 'in_progress' | 'completed' | 'failed', required: Status of a business verification request. - `verification_type` 'business_search' | 'online_presence' | 'lien_search' | 'docket_search' | 'comprehensive', required: Type of business verification to perform. - `requested_at` string, date-time, required: When the verification was requested. - `completed_at` string, date-time, nullable, required: When the verification completed (success or failure). - `is_verified` boolean, nullable, required: Overall verification result - True if business is verified, False if not, None if pending. - `verification_rating` string, nullable, required: Verification quality rating (A, B, C, F). Null if vendor doesn't provide. - `risk_rating` string, nullable, required: Risk assessment rating (A, B, C, F). Null if vendor doesn't provide. - `error_message` string, nullable, required: Error message if verification failed. - `verification_score` integer, nullable, required: Verification quality score (0-100). Null if vendor doesn't provide. - `risk_score` integer, nullable, required: Risk assessment score (0-100). Null if vendor doesn't provide. - `sos_status` 'active' | 'inactive' | 'dissolved' | 'suspended' | 'forfeited' | 'withdrawn' | 'merged' | 'converted' | 'unknown', required: Secretary of State registration status. - `sos_standing` string, nullable, required: SOS standing (e.g., 'GOOD STANDING', 'SUSPENDED'). Distinct from sos_status. - `sos_file_number` string, nullable, required: Secretary of State filing/file number. - `registration_type` string, nullable, required: SOS registration type (e.g., 'domestic', 'foreign'). - `registered_name` string, nullable, required: Official business name on the SOS registration (may differ from search name). - `business_structure` 'llc' | 'corporation' | 'sole_proprietorship' | 'partnership' | 'limited_partnership' | 'llp' | 'nonprofit' | 'professional_corporation' | 'trust' | 'cooperative' | 'other', required: Legal structure of the business. - `business_address` string, nullable, required: Legal entity address as reported by vendor. - `formation_date` string, date, nullable, required: Date the business was formed/incorporated. - `inactive_date` string, date, nullable, required: Date the business became inactive, if applicable. - `dissolution_date` string, date, nullable, required: Date the business was dissolved, if applicable. - `domestic_state` string, nullable, required: Two-letter state code where business is domiciled. - `registered_agent_name` string, nullable, required: Name of the registered/statutory agent. - `registered_agent_address` object, nullable, required: Full address of the registered agent (street, city, state, zip). - `alternative_names` string[], nullable, required: Alternate business names / DBAs from official records. - `registered_address` object, nullable, required: Full registered address from SOS records (street, city, state, zip). - `name_verified` boolean, nullable, required: Whether the business name was verified against official records. - `name_match_quality` string, nullable, required: Raw name match quality from vendor (e.g., 'EXACT', 'PARTIAL', 'NO_MATCH'). - `address_verified` boolean, nullable, required: Whether the business address was verified. - `address_match_quality` string, nullable, required: Raw address match quality from vendor (e.g., 'EXACT', 'PARTIAL', 'NO_MATCH'). - `tin_verified` boolean, nullable, required: Whether the Tax ID (TIN/EIN) was verified with IRS records. - `address_type` 'street' | 'high_rise' | 'po_box' | 'rural_route' | 'general_delivery' | 'cmra' | 'virtual_office', required: USPS address classification and risk indicators. - `is_residential` boolean, nullable, required: True if address is classified as residential (RDI indicator). - `naics_code` string, nullable, required: 6-digit NAICS industry code. - `mcc_code` string, nullable, required: 4-digit Merchant Category Code. - `sic_code` string, nullable, required: 4-digit Standard Industrial Classification code. - `industry_description` string, nullable, required: Human-readable industry description. - `industry_confidence` number, nullable, required: Industry prediction confidence score (0.0-1.0). - `naics_risk_level` string, nullable, required: NAICS risk level from prediction (e.g. 'high', 'medium', 'low'). - `mcc_codes` KYBIndustryCode[], nullable, required: All predicted MCC codes from vendor [{code, description}, ...]. - `code` string, nullable, required - `description` string, nullable, required - `visa_risk_tier` string, nullable, required - `mastercard_risk` boolean, nullable, required - `sic_codes` KYBIndustryCode[], nullable, required: All predicted SIC codes from vendor [{code, description}, ...]. - `code` string, nullable, required - `description` string, nullable, required - `visa_risk_tier` string, nullable, required - `mastercard_risk` boolean, nullable, required - `industry_keywords` string[], nullable, required: Industry classification keywords from NAICS prediction. - `industry_reasoning` string, nullable, required: LLM reasoning for the NAICS industry classification. - `website_url` string, nullable, required: Discovered or verified business website URL. - `domain_age_days` integer, nullable, required: Age of the domain in days. - `has_ssl` boolean, nullable, required: Whether the website has a valid SSL certificate. - `email_deliverable` boolean, nullable, required: Whether email to the business domain is deliverable. - `officer_count` integer, nullable, required: Number of officers discovered. - `officer_match` boolean, nullable, required: True if any provided officer name matched discovered officers. - `active_lien_count` integer, nullable, required: Total count of active liens (UCC, tax, judgment). - `active_ucc_count` integer, nullable, required: Count of active UCC filings. - `tax_lien_found` boolean, nullable, required: True if any tax liens (federal or state) were found. - `judgment_found` boolean, nullable, required: True if any judgment liens were found. - `watchlist_clear` boolean, nullable, required: True if no hits on any sanctions/watchlists. False if any hits found. - `ofac_clear` boolean, nullable, required: True if no OFAC (SDN, SSI, etc.) hits found. - `pep_found` boolean, nullable, required: True if any Politically Exposed Person matches found. - `registrations` KYBRegistrationSummary[], required: SoS registrations across all states. - `created_at` string, date-time, required - `modified_at` string, date-time, nullable, required - `id` string, required - `registration_type` string, required: Registration type from SoS (e.g., 'domestic', 'foreign'). - `state` string, nullable, required: Two-letter state code for this registration. - `status` 'active' | 'inactive' | 'dissolved' | 'suspended' | 'forfeited' | 'withdrawn' | 'merged' | 'converted' | 'unknown', required: Secretary of State registration status. - `standing` string, nullable, required: SOS standing (e.g., 'Good Standing', 'Suspended'). - `file_number` string, nullable, required: Secretary of State filing/file number. - `registered_name` string, nullable, required: Business name as registered in this state. - `issue_date` string, date, nullable, required: Date the registration was issued. - `inactive_date` string, date, nullable, required: Date the registration became inactive, if applicable. - `dissolution_date` string, date, nullable, required: Date the business was dissolved in this state, if applicable. - `registered_agent_name` string, nullable, required: Name of the registered/statutory agent in this state. - `registered_agent_address` object, nullable, required: Full address of the registered agent (street, city, state, zip). - `registered_address` object, nullable, required: Registered address in this state (street, city, state, zip). - `object` string, required: String representing the object's type. Objects of the same type share the same value. - `addresses` KYBAddressSummary[], required: Addresses associated with the business. - `created_at` string, date-time, required - `modified_at` string, date-time, nullable, required - `id` string, required - `street` string, nullable, required: Street address line. - `city` string, nullable, required: City name. - `state` string, nullable, required: Two-letter state code. - `zip` string, nullable, required: ZIP or postal code. - `address_type` 'street' | 'high_rise' | 'po_box' | 'rural_route' | 'general_delivery' | 'cmra' | 'virtual_office', required: USPS address classification and risk indicators. - `is_cmra` boolean, nullable, required: True if address is a Commercial Mail Receiving Agency. - `is_residential` boolean, nullable, required: True if address is classified as residential (RDI indicator). - `object` string, required: String representing the object's type. Objects of the same type share the same value. - `officers` KYBOfficerSummary[], required: Officers discovered during verification. - `created_at` string, date-time, required - `modified_at` string, date-time, nullable, required - `id` string, required - `name` string, required: Full name of the officer. - `title` string, nullable, required: Officer title (CEO, Managing Member, Registered Agent, etc.). - `source` 'sos' | 'website' | 'linkedin' | 'input' | 'other', required: Source where officer information was discovered. - `is_input_match` boolean, nullable, required: True if this officer matches a name provided in verification input. - `match_score` number, nullable, required: Fuzzy match confidence score (0.0-1.0) if matched against input. - `watchlist_clear` boolean, nullable, required: True if this individual has no watchlist hits. - `pep_status` boolean, nullable, required: True if this individual is a Politically Exposed Person. - `object` string, required: String representing the object's type. Objects of the same type share the same value. - `liens` KYBLienSummary[], required: Liens and filings discovered during verification. - `created_at` string, date-time, required - `modified_at` string, date-time, nullable, required - `id` string, required - `filing_number` string, nullable, required: Official filing number from the recording office. - `filing_type` 'ucc1' | 'ucc3_continuation' | 'ucc3_amendment' | 'ucc3_assignment' | 'ucc3_termination' | 'ucc5' | 'federal_tax_lien' | 'state_tax_lien' | 'judgment' | 'mechanics_lien' | 'other', required: Type of lien or public filing. - `status` 'active' | 'terminated' | 'lapsed' | 'amended', required: Current status of a lien filing. - `filed_date` string, date, nullable, required: Date the lien was filed. - `expiration_date` string, date, nullable, required: Date the lien expires or lapsed. - `secured_party` string, nullable, required: Name of the secured party (lender). May be masked. - `is_blanket_lien` boolean, nullable, required: True if this is an 'all assets' blanket lien. - `collateral_description` string, nullable, required: Description of collateral covered by the lien. - `object` string, required: String representing the object's type. Objects of the same type share the same value. - `watchlist_hits` KYBWatchlistHitSummary[], required: Watchlist/sanctions matches found during verification. - `created_at` string, date-time, required - `modified_at` string, date-time, nullable, required - `id` string, required - `list_type` 'ofac' | 'csl' | 'cns' | 'fbi' | 'pep' | 'ieo' | 'other', required: Baselayer watchlist/sanctions screening codes. - `list_name` string, nullable, required: Specific list name if more granular than list_type (e.g., specific OFAC program). - `matched_name` string, nullable, required: The name on the watchlist that matched. Null for zero-hit screenings. - `match_score` number, nullable, required: Fuzzy match confidence score (0.0-1.0). - `matched_entity_type` string, nullable, required: What was matched: 'business' or 'officer'. Null for zero-hit screenings. - `matched_entity_name` string, nullable, required: The input name (business or officer) that triggered the match. Null for zero-hit screenings. - `is_false_positive` boolean, nullable, required: True if manually reviewed and determined to be a false positive. - `object` string, required: String representing the object's type. Objects of the same type share the same value. - `website_analysis_detail` KYBWebsiteAnalysisSummary, required: Website analysis data from online presence verification. - `created_at` string, date-time, required - `modified_at` string, date-time, nullable, required - `id` string, required - `url` string, nullable, required: The URL that was analyzed. - `parked` boolean, nullable, required: True if the domain is parked (no real content). - `email_deliverable` boolean, nullable, required: Whether email to the business domain is deliverable. - `ssl_valid` boolean, nullable, required: Whether the website has a valid SSL certificate. - `website_build_status` string, nullable, required: Website build status (e.g., 'active', 'parked', 'inactive'). - `website_summary` string, nullable, required: AI-generated summary of the business from website content. - `screenshot_url` string, nullable, required: URL to a cached screenshot of the website. - `emails` string[], nullable, required: Email addresses extracted from the website (JSON array of strings). - `phone_numbers` string[], nullable, required: Phone numbers extracted from the website (JSON array of strings). - `social_profiles` object[], nullable, required: Social media profiles found (JSON array of {site, url, username}). - `object` string, required: String representing the object's type. Objects of the same type share the same value. - `input_data` object, nullable, required: The data sent to the vendor for verification (business_name, tax_id, address, etc.). - `object` string, required: String representing the object's type. Objects of the same type share the same value. ## Other responses - `422`: Validation Error --- [API](https://skmtc.dev/stuut/apis/stuut-api.md) - [All operations](https://skmtc.dev/stuut/apis/stuut-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stuut/apis/stuut-api/revisions/ff0ad16a55ff?raw)