Skip to main content
The KYB Certificate is a reusable Know Your Business attestation that packages UBO (ultimate beneficial owner), incorporation, and business-identity evidence into a single certificate. Rather than each institution repeating registry lookups, ownership tracing, and risk screening for the same business, a query assembles the verification work already furnished by network participants into one network-issued result.
CategoryIdentity Verification
Use caseCustomer onboarding
SubjectBusiness
FamilyCertificate (issues a certificate_id)
OperationsPOST /v1/products/kyb_certificate/query, POST /v1/products/kyb_certificate/furnish

​
What’s in the certificate

A KYB certificate consolidates three sub-products, each a block in the query response with its own assertions (what was attested, and when) and data (the supporting attributes):
Sub-productResponse keyWhat it attests
Business identity verificationbusiness_identity_verificationThe legal entity exists and is what it claims — registration, jurisdiction, tax ID validation, operational existence.
Ownership & control verificationbusiness_ownership_control_verificationBeneficial owners, control persons, and authorized representatives were identified and evidenced.
Risk & compliance assessmentbusiness_risk_compliance_assessmentSanctions, adverse media, restricted-activity, and activity-risk screening were performed.
Every populated sub-product carries the furnishing_entity_id of the participant whose data backed it and the attestation_id of their attestation.

​
At a glance

curl -X POST https://api.solo.one/v1/products/kyb_certificate/query \
  -H "Authorization: Bearer $SOLO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "consent_id": "a3f0b9c7-…",
    "policy_id": "5e7d2a14-…",
    "network_ids": ["9f1c0c2e-…"]
  }'
A 200 OK means a certificate was issued — the response carries a certificate_id, the billable query_event_id, and a result block with each sub-product (sub-products without qualifying data are null). A 204 No Content means the available data did not satisfy the policy.

Full field reference & response schema

The complete KYB certificate deep dive — every model, the full response example, how it resolves per network, and the 204 rules.

Products

The full product catalog.

Coverage check

Check field coverage before running a billable query.