Skip to main content
The KYC Certificate is a reusable identity-verification certificate for consumer onboarding. Instead of each institution re-running document capture, biometric checks, and identity corroboration for the same person, a query assembles the verification work already furnished by network participants into a single network-issued certificate.
CategoryIdentity Verification
Use caseCustomer onboarding
SubjectConsumer
FamilyCertificate (issues a certificate_id)
OperationsPOST /v1/products/kyc_certificate/query, POST /v1/products/kyc_certificate/furnish

​
What’s in the certificate

A KYC certificate consolidates up to nine 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
Document capturedocument_captureAn identity document was captured, with its type, number, and dates.
Document reviewdocument_reviewThe document’s attributes were reviewed — tamper and machine-readable-data checks.
Biometric capturebiometric_captureA biometric artifact (e.g. a selfie) was captured.
Biometric reviewbiometric_reviewThe biometric was compared against a reference, with quality and outcome.
Liveness captureliveness_captureLiveness evidence was captured.
Liveness reviewliveness_reviewThe liveness evidence was reviewed, with outcome and confidence tier.
Address captureaddress_captureA residential address was captured.
Address verificationaddress_verificationThe address was verified, with methods and per-source match counts.
Identity corroborationidentity_corroborationCIP-style corroboration — SSN, name, and DOB matches across sources.
Every populated sub-product carries the furnishing_entity_id of the participant whose data backed it and the attestation_id of their attestation, so the certificate is auditable down to its sources.

​
At a glance

curl -X POST https://api.solo.one/v1/products/kyc_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 requested sub-product (sub-products the policy didn’t require, or that lacked data, are null). A 204 No Content means the available data did not satisfy the policy.

Full field reference & response schema

The complete KYC 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.