Document Submission

Create a document submission case for a customer to provide additional documents during identity verification.

Create a document submission case

Initiate a Document Submission case for an individual or business customer who needs to provide additional documents for an ongoing KYC/KYB identity verification:

POST /api/identity_verifications

{  
  "type": "kyc",  
  "method": "document_submission",  
  "customer_guid": "customer_guid"  
}

{
  "created_at": "datetime",
  "updated_at": "datetime",
  "type": "kyc",
  "guid": "identity_verification_guid",
  "method": "document_submission",
  "customer_guid": "customer_guid",
  "state": "storing",
  "outcome": null,
  "failure_codes": [],
  "compliance_decisions": []
}

Retrieve the Persona inquiry ID

Retrieve the persona_inquiry_id to pass to the Persona SDK:

GET /api/identity_verifications/{identity_verification_guid}

{
  "created_at": "datetime",
  "updated_at": "datetime",
  "type": "kyc",
  "guid": "identity_verification_guid",
  "method": "document_submission",
  "customer_guid": "customer_guid",
  "state": "waiting",
  "outcome": null,
  "failure_codes": [],
  "persona_inquiry_id": "inq_XXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "persona_state": "waiting",
  "compliance_checks": [],
  "compliance_decisions": []
}

API errors

❗️
Duplicate case error
If you create a document submission case for a customer that already has one in the waiting state, the API returns a 409 error:

{
  "status": 409,
  "error_message": "Identity verification in progress already exists",
  "message_code": "data_exists"
}

For more details on identity verifications and state descriptions, see the API reference.

Updated 11 days ago