Get detailed KYC verification information
Get detailed KYC verification information.
Returns GDPR-compliant KYC details including personal information (name only), document submission status, and verification results. This endpoint only returns data that Sumvin stores locally - full KYC data is held by Sumsub.
Data Minimization: Only the user’s name is stored locally. All other identity documents and PII are stored and processed by Sumsub.
Caching: Results are cached for 5 minutes. Use refresh=true to
fetch the latest data from Sumsub.
Authorizations
Personal access token issued to the Sumvin CLI. Send it in the x-sumvin-pat header to authenticate as the owning user.
Headers
Tenant org ID for multi-tenant auth
Controls how timestamp fields are serialized in JSON response bodies.
Default (header omitted or any other value): epoch milliseconds as integers.
iso8601: UTC ISO 8601 strings of the form YYYY-MM-DDTHH:MM:SSZ.
Example: with X-Timestamp-Format: iso8601, the field value 1704067200000 becomes "2024-01-01T00:00:00Z".
Affected fields (recursively, in dicts and arrays): any field whose name ends in _at, plus the literal field names timestamp, period_start, and period_end. All other fields are passed through unchanged.
Only iso8601 is recognized. Any other value (or omitting the header) yields the default epoch-ms representation; the server does not reject unknown values, so this is documented as an example rather than an enum to keep generated clients permissive.
"iso8601"
Query Parameters
Response
KYC details retrieved successfully
Detailed KYC verification information (GDPR-compliant).
HAL-style hypermedia links for navigation.
Current KYC status: pending, in_progress, retry, approved, or rejected.
Timestamp when KYC was approved (epoch milliseconds).
Timestamp when KYC was rejected (epoch milliseconds).
Timestamp when KYC verification was started (epoch milliseconds).
Personal information from KYC. Only name is stored locally.
List of submitted documents and their verification status.
True if all required documents have been submitted.
True if verification passed all checks.
Rejection details if KYC was rejected or needs retry.