Kraken Embed

Submit User Verification

Submit identity verification details for a Kraken Embed user. Supports various verification types including identity documents, residence documents, tax IDs, selfies, watchlists, and KYC reports.

post/v1/kraken_embed/users/{user_id}/verifications

Request

  • Base URL
    https://api.privy.io
  • URL
    https://api.privy.io/v1/kraken_embed/users/{user_id}/verifications
  • Auth
    HTTP basic

Path parameters

user_idstring required

The ID of the Privy user.

Headers

privy-app-idstring required

ID of your Privy app.

Request body multipart/form-data

type'identity_document' | 'residence_document' | 'tax_id_document' | 'selfie' | 'watchlists' | 'kyc_report' required

Type of verification being submitted.

metadatastring required

JSON string containing verification metadata.

frontstring binary

Front image of identity document (for identity_document type).

backstring binary

Back image of identity document (for identity_document type).

documentstring binary

Document file (for residence_document or tax_id_document types).

selfiestring binary

Selfie image or video (for selfie type).

kyc_reportstring binary

KYC report file (for kyc_report type).

verifier_responsestring binary

Optional verifier response document.

Example request

{
  "type": "identity_document",
  "metadata": "{\"verifier\":\"example_kyc_provider\",\"verified_at\":\"2024-04-15T10:00:00Z\",\"identity\":{\"full_name\":{\"first_name\":\"John\",\"middle_name\":null,\"last_name\":\"Doe\"},\"date_of_birth\":\"1990-01-15\"},\"document_type\":\"passport\",\"document_number\":\"P123456789\",\"issuing_country\":\"US\"}"
}

Response

Verification submitted successfully.

object required

Empty response on successful verification submission.

Changes

No recorded changes to this operation across all 60 revisions of this API.