Get KYC status
Returns the normalized Pods KYC status for a Pods-generated kycUserId. This is the canonical status endpoint for both Sumsub share-token profiles and BigDataCorp iframe profiles. BigDataCorp profiles are polled while capture is pending; pending Avenia KYC attempts are refreshed before returning when possible. Pods also runs a durable background task to update the stored KYC state when clients stop polling.
Authorizations
API key for authentication. Obtain from your Pods dashboard.
Query Parameters
Pods-generated KYC user id returned by /api/v1/kyc/sumsub-share-token or /api/v1/kyc/bigdatacorp/sessions
"550e8400-e29b-41d4-a716-446655440000"
Response
KYC status retrieved
Current normalized KYC profile status
Pods-generated public KYC user id
"550e8400-e29b-41d4-a716-446655440000"
KYC provider used for the profile
sumsub, bigdatacorp "sumsub"
Ethereum address (EVM-compatible)
"0xb794F5eA0ba39494cE839613fffBA74279579268"
Normalized Pods KYC status
created, provider_pending, approved, rejected, rejected_retryable, blocked "provider_pending"
false
"COMPLETED"
Provider-specific normalized result. BigDataCorp may return values such as WAITING_ADDRESS_TO_SUBMIT_TO_AVENIA, DUPLICATE_TAX_ID, or AVENIA_KYC_SUBMIT_FAILED before the final Pods status is approved.
"APPROVED"
Provider message persisted for support and retry decisions, when available.
"passed"
"passed"
Resolved birth date in YYYY-MM-DD format for BigDataCorp profiles. Null while pending, unavailable, or not applicable to the provider.
"1990-01-01T00:00:00.000Z"
36
When the current BigDataCorp iframe session was created.
"2026-06-15T12:00:00.000Z"
When BigDataCorp completed document, liveness, and identity verification.
"2026-06-15T12:04:00.000Z"
When Pods started the final Avenia submission. Repeated submit requests return the existing provider_pending result while this operation is in progress.
"2026-06-15T12:04:30.000Z"
When the verified BigDataCorp profile was submitted to Avenia.
"2026-06-15T12:05:00.000Z"
When Avenia approved the KYC attempt and BRLA became enabled.
"2026-06-15T12:06:00.000Z"
"2026-06-15T12:01:00.000Z"