STstuut
kyb

Get Verification

Get KYB Verification Detail

Returns detailed verification results including officers, liens, and watchlist hits.

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)
  • Auth
    HTTP bearer

Path parameters

partner_idstring required
verification_idstring required

Response

Successful Response

created_atstring date-time required
modified_atstring date-time nullable required
idstring 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_atstring date-time required

When the verification was requested.

completed_atstring date-time nullable required

When the verification completed (success or failure).

is_verifiedboolean nullable required

Overall verification result - True if business is verified, False if not, None if pending.

verification_ratingstring nullable required

Verification quality rating (A, B, C, F). Null if vendor doesn't provide.

risk_ratingstring nullable required

Risk assessment rating (A, B, C, F). Null if vendor doesn't provide.

error_messagestring nullable required

Error message if verification failed.

verification_scoreinteger nullable required

Verification quality score (0-100). Null if vendor doesn't provide.

risk_scoreinteger 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_standingstring nullable required

SOS standing (e.g., 'GOOD STANDING', 'SUSPENDED'). Distinct from sos_status.

sos_file_numberstring nullable required

Secretary of State filing/file number.

registration_typestring nullable required

SOS registration type (e.g., 'domestic', 'foreign').

registered_namestring 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_addressstring nullable required

Legal entity address as reported by vendor.

formation_datestring date nullable required

Date the business was formed/incorporated.

inactive_datestring date nullable required

Date the business became inactive, if applicable.

dissolution_datestring date nullable required

Date the business was dissolved, if applicable.

domestic_statestring nullable required

Two-letter state code where business is domiciled.

registered_agent_namestring nullable required

Name of the registered/statutory agent.

registered_agent_addressobject nullable required

Full address of the registered agent (street, city, state, zip).

alternative_namesstring[] nullable required

Alternate business names / DBAs from official records.

registered_addressobject nullable required

Full registered address from SOS records (street, city, state, zip).

name_verifiedboolean nullable required

Whether the business name was verified against official records.

name_match_qualitystring nullable required

Raw name match quality from vendor (e.g., 'EXACT', 'PARTIAL', 'NO_MATCH').

address_verifiedboolean nullable required

Whether the business address was verified.

address_match_qualitystring nullable required

Raw address match quality from vendor (e.g., 'EXACT', 'PARTIAL', 'NO_MATCH').

tin_verifiedboolean 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_residentialboolean nullable required

True if address is classified as residential (RDI indicator).

naics_codestring nullable required

6-digit NAICS industry code.

mcc_codestring nullable required

4-digit Merchant Category Code.

sic_codestring nullable required

4-digit Standard Industrial Classification code.

industry_descriptionstring nullable required

Human-readable industry description.

industry_confidencenumber nullable required

Industry prediction confidence score (0.0-1.0).

naics_risk_levelstring nullable required

NAICS risk level from prediction (e.g. 'high', 'medium', 'low').

industry_keywordsstring[] nullable required

Industry classification keywords from NAICS prediction.

industry_reasoningstring nullable required

LLM reasoning for the NAICS industry classification.

website_urlstring nullable required

Discovered or verified business website URL.

domain_age_daysinteger nullable required

Age of the domain in days.

has_sslboolean nullable required

Whether the website has a valid SSL certificate.

email_deliverableboolean nullable required

Whether email to the business domain is deliverable.

officer_countinteger nullable required

Number of officers discovered.

officer_matchboolean nullable required

True if any provided officer name matched discovered officers.

active_lien_countinteger nullable required

Total count of active liens (UCC, tax, judgment).

active_ucc_countinteger nullable required

Count of active UCC filings.

tax_lien_foundboolean nullable required

True if any tax liens (federal or state) were found.

judgment_foundboolean nullable required

True if any judgment liens were found.

watchlist_clearboolean nullable required

True if no hits on any sanctions/watchlists. False if any hits found.

ofac_clearboolean nullable required

True if no OFAC (SDN, SSI, etc.) hits found.

pep_foundboolean nullable required

True if any Politically Exposed Person matches found.

input_dataobject nullable required

The data sent to the vendor for verification (business_name, tax_id, address, etc.).

objectstring required

String representing the object's type. Objects of the same type share the same value.

Changes

No recorded changes to this operation across all 1 revision of this API.