Get Verification - Stuut API

{ "created_at": "2023-11-07T05:31:56Z", "modified_at": "2023-11-07T05:31:56Z", "id": "<string>", "requested_at": "2023-11-07T05:31:56Z", "completed_at": "2023-11-07T05:31:56Z", "is_verified": true, "verification_rating": "<string>", "risk_rating": "<string>", "error_message": "<string>", "verification_score": 123, "risk_score": 123, "sos_standing": "<string>", "sos_file_number": "<string>", "registration_type": "<string>", "registered_name": "<string>", "business_address": "<string>", "formation_date": "2023-12-25", "inactive_date": "2023-12-25", "dissolution_date": "2023-12-25", "domestic_state": "<string>", "registered_agent_name": "<string>", "registered_agent_address": {}, "alternative_names": [ "<string>" ], "registered_address": {}, "name_verified": true, "name_match_quality": "<string>", "address_verified": true, "address_match_quality": "<string>", "tin_verified": true, "is_residential": true, "naics_code": "<string>", "mcc_code": "<string>", "sic_code": "<string>", "industry_description": "<string>", "industry_confidence": 123, "naics_risk_level": "<string>", "mcc_codes": [ { "code": "<string>", "description": "<string>", "visa_risk_tier": "<string>", "mastercard_risk": true } ], "sic_codes": [ { "code": "<string>", "description": "<string>", "visa_risk_tier": "<string>", "mastercard_risk": true } ], "industry_keywords": [ "<string>" ], "industry_reasoning": "<string>", "website_url": "<string>", "domain_age_days": 123, "has_ssl": true, "email_deliverable": true, "officer_count": 123, "officer_match": true, "active_lien_count": 123, "active_ucc_count": 123, "tax_lien_found": true, "judgment_found": true, "watchlist_clear": true, "ofac_clear": true, "pep_found": true, "registrations": [ { "created_at": "2023-11-07T05:31:56Z", "modified_at": "2023-11-07T05:31:56Z", "id": "<string>", "registration_type": "<string>", "state": "<string>", "standing": "<string>", "file_number": "<string>", "registered_name": "<string>", "issue_date": "2023-12-25", "inactive_date": "2023-12-25", "dissolution_date": "2023-12-25", "registered_agent_name": "<string>", "registered_agent_address": {}, "registered_address": {}, "object": "<string>" } ], "addresses": [ { "created_at": "2023-11-07T05:31:56Z", "modified_at": "2023-11-07T05:31:56Z", "id": "<string>", "street": "<string>", "city": "<string>", "state": "<string>", "zip": "<string>", "is_cmra": true, "is_residential": true, "object": "<string>" } ], "officers": [ { "created_at": "2023-11-07T05:31:56Z", "modified_at": "2023-11-07T05:31:56Z", "id": "<string>", "name": "<string>", "title": "<string>", "is_input_match": true, "match_score": 123, "watchlist_clear": true, "pep_status": true, "object": "<string>" } ], "liens": [ { "created_at": "2023-11-07T05:31:56Z", "modified_at": "2023-11-07T05:31:56Z", "id": "<string>", "filing_number": "<string>", "filed_date": "2023-12-25", "expiration_date": "2023-12-25", "secured_party": "<string>", "is_blanket_lien": true, "collateral_description": "<string>", "object": "<string>" } ], "watchlist_hits": [ { "created_at": "2023-11-07T05:31:56Z", "modified_at": "2023-11-07T05:31:56Z", "id": "<string>", "list_name": "<string>", "matched_name": "<string>", "match_score": 123, "matched_entity_type": "<string>", "matched_entity_name": "<string>", "is_false_positive": true, "object": "<string>" } ], "website_analysis_detail": { "created_at": "2023-11-07T05:31:56Z", "modified_at": "2023-11-07T05:31:56Z", "id": "<string>", "url": "<string>", "parked": true, "email_deliverable": true, "ssl_valid": true, "website_build_status": "<string>", "website_summary": "<string>", "screenshot_url": "<string>", "emails": [ "<string>" ], "phone_numbers": [ "<string>" ], "social_profiles": [ {} ], "object": "<string>" }, "input_data": {}, "object": "<string>" }

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

partner_id

string

required

verification_id

string

required

Response

Successful Response

Full KYB verification details.

created_at

string<date-time>

required

modified_at

string<date-time> | null

required

string

required

status

enum<string>

required

Current status of the verification request.

Available options:

pending,

in_progress,

completed,

failed

verification_type

enum<string>

required

The type of verification performed.

Available options:

business_search,

online_presence,

lien_search,

docket_search,

comprehensive

requested_at

string<date-time>

required

When the verification was requested.

completed_at

string<date-time> | null

required

When the verification completed (success or failure).

is_verified

boolean | null

required

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

verification_rating

string | null

required

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

risk_rating

string | null

required

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

error_message

string | null

required

Error message if verification failed.

verification_score

integer | null

required

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

risk_score

integer | null

required

Risk assessment score (0-100). Null if vendor doesn't provide.

sos_status

enum<string> | null

required

Secretary of State registration status.

Available options:

active,

inactive,

dissolved,

suspended,

forfeited,

withdrawn,

merged,

converted,

unknown

sos_standing

string | null

required

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

sos_file_number

string | null

required

Secretary of State filing/file number.

registration_type

string | null

required

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

registered_name

string | null

required

Official business name on the SOS registration (may differ from search name).

business_structure

enum<string> | null

required

Legal structure of the business.

Available options:

llc,

corporation,

sole_proprietorship,

partnership,

limited_partnership,

llp,

nonprofit,

professional_corporation,

trust,

cooperative,

other

business_address

string | null

required

Legal entity address as reported by vendor.

formation_date

string<date> | null

required

Date the business was formed/incorporated.

inactive_date

string<date> | null

required

Date the business became inactive, if applicable.

dissolution_date

string<date> | null

required

Date the business was dissolved, if applicable.

domestic_state

string | null

required

Two-letter state code where business is domiciled.

registered_agent_name

string | null

required

Name of the registered/statutory agent.

registered_agent_address

object

required

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

alternative_names

string[] | null

required

Alternate business names / DBAs from official records.

registered_address

object

required

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

name_verified

boolean | null

required

Whether the business name was verified against official records.

name_match_quality

string | null

required

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

address_verified

boolean | null

required

Whether the business address was verified.

address_match_quality

string | null

required

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

tin_verified

boolean | null

required

Whether the Tax ID (TIN/EIN) was verified with IRS records.

address_type

enum<string> | null

required

USPS address classification and risk indicators.

Available options:

street,

high_rise,

po_box,

rural_route,

general_delivery,

cmra,

virtual_office

is_residential

boolean | null

required

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

naics_code

string | null

required

6-digit NAICS industry code.

mcc_code

string | null

required

4-digit Merchant Category Code.

sic_code

string | null

required

4-digit Standard Industrial Classification code.

industry_description

string | null

required

Human-readable industry description.

industry_confidence

number | null

required

Industry prediction confidence score (0.0-1.0).

naics_risk_level

string | null

required

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

mcc_codes

KYBIndustryCode · object[] | null

required

All predicted MCC codes from vendor [{code, description}, ...].

Show child attributes

sic_codes

KYBIndustryCode · object[] | null

required

All predicted SIC codes from vendor [{code, description}, ...].

Show child attributes

industry_keywords

string[] | null

required

Industry classification keywords from NAICS prediction.

industry_reasoning

string | null

required

LLM reasoning for the NAICS industry classification.

website_url

string | null

required

Discovered or verified business website URL.

domain_age_days

integer | null

required

Age of the domain in days.

has_ssl

boolean | null

required

Whether the website has a valid SSL certificate.

email_deliverable

boolean | null

required

Whether email to the business domain is deliverable.

officer_count

integer | null

required

Number of officers discovered.

officer_match

boolean | null

required

True if any provided officer name matched discovered officers.

active_lien_count

integer | null

required

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

active_ucc_count

integer | null

required

Count of active UCC filings.

tax_lien_found

boolean | null

required

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

judgment_found

boolean | null

required

True if any judgment liens were found.

watchlist_clear

boolean | null

required

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

ofac_clear

boolean | null

required

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

pep_found

boolean | null

required

True if any Politically Exposed Person matches found.

registrations

KYBRegistrationSummary · object[]

required

SoS registrations across all states.

Show child attributes

addresses

KYBAddressSummary · object[]

required

Addresses associated with the business.

Show child attributes

officers

KYBOfficerSummary · object[]

required

Officers discovered during verification.

Show child attributes

liens

KYBLienSummary · object[]

required

Liens and filings discovered during verification.

Show child attributes

watchlist_hits

KYBWatchlistHitSummary · object[]

required

Watchlist/sanctions matches found during verification.

Show child attributes

website_analysis_detail

KYBWebsiteAnalysisSummary · object

required

Website analysis data from online presence verification.

Show child attributes

input_data

object

required

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

object

string

required

read-only

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

API Reference

Documentation Index

Authorizations

Path Parameters

Response