Document Submission

You can initiate a Document Submission case for an individual or a business customer who wants to provide additional or supplementary documents for an ongoing KYC/KYB identity verification case using the following API request:

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": []
}

Next, you can retrieve the persona_inquiry_id so you can later pass it to the Persona SDK component using the following API request:

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_iTauhYQpWjkwcMijv92gekmCZRTH",
  "persona_state": "waiting",
  "compliance_checks": [],
  "compliance_decisions": []
}

API Errors

💡
If you try to create a document submission case for a customer that already has a document submission case in the waiting state, you will receive the following API error:
{
  "status": 409,
  "error_message": "Identity verification in progress already exists",
  "message_code": "data_exists"
}

For more details on Identity Verifications, such as state descriptions, please check out our API reference here.