Skip to main content
GET
Get Verification

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
id
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 | null
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 | null
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}, ...].

sic_codes
KYBIndustryCode · object[] | null
required

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

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.

addresses
KYBAddressSummary · object[]
required

Addresses associated with the business.

officers
KYBOfficerSummary · object[]
required

Officers discovered during verification.

liens
KYBLienSummary · object[]
required

Liens and filings discovered during verification.

watchlist_hits
KYBWatchlistHitSummary · object[]
required

Watchlist/sanctions matches found during verification.

website_analysis_detail
KYBWebsiteAnalysisSummary · object | null
required

Website analysis data from online presence verification.

input_data
object | null
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.