👍

This doc has been updated with Priority specifications.

🚧

Advanced KYC ONLY

If you're using legacy Classic KYC, use /check_kyc.

Takes a single user_handle and returns a list of verification records with some associated data, including verification_uuid and verification_status.

Use this endpoint to retrieve verification_uuid for an entity if needed. Use /get_verifications/<verification_uuid> for further details on a single verification record, including reasons strings.

Request

Authorization / Authentication

Apps using Access Token Authorization

Use a valid access token in an Authorization: Bearer request header.

See Auth Token Overview for more details.

NOTE: Though we recommend using JWT, you can use this endpoint with ECDSA.

POST /0.2/get_verifications HTTP/1.1
sandbox.silamoney.com
Content-Type: application/json
Authorization: Bearer [GENERATED JWT TOKEN HERE]

{
  "header": {
    "created": 1234567890, //required
    "app_handle": "your_app_handle", //required
    "user_handle":"you_user_handle", //required
    "version": "0.2", 
    "reference": "<your unique id>"
  }
}

***

HTTP/1.1 200 OK

{
  "success": True,
  "reference": "<your unique id>",
  "sila_reference_id": "sila_assigned_id",
  "verifications": [{
     "verification_uuid": "<uuid>",
     "flow": "<uuid of KYC Flow>",
     "verification_status": "<name of verification status>",
     "requested_at": "<timestamp of /kyc call>"      
    }]
}

Request Attributes

Verification Statuses

If verification_status is documents_required

🚧

Automatic failure after 30 days

If you have an end user that has remained in a documents_required status for 30 days, they will automatically fail KYC.

You can confirm the failure is due to expiration by checking for LEAD TIME EXPIRED returned as a reason by /get_verification/verification_uuid.

If you have an end user in this scenario, proceed by calling /kyc again. This will create a new verification record with a new verification_uuid to upload docs to. The original record will remain in failed.

This means that further verification is required to pass this end user through KYC successfully, and documents need to be uploaded via /documents.

• Use the reasons provided by /get_verifications/<verification_uuid> to determine the type of doc to upload, then use /documents to upload any necessary docs. You can find a mapping laid out in our docs here.
  • reasons are returned as an array of strings. A few examples include:
    • Unable to verify business name, address, TIN and phone on business records
    • Unable to verify SSN/TIN
    • Unable to verify date-of-birth
  • There are approximately 130 possible reason strings. We have that full list mapped to the type of verification needed available upon request.
• If a verification record goes to documents_required and documents are not uploaded within 30 days, that verification record will automatically expire and verification status will transition to failed.
  • You can confirm the failure is due to expiration by checking for LEAD TIME EXPIRED returned as a reason by /get_verification/verification_uuid.
  • If you have an end user in this scenario, proceed by calling /kyc again. This will create a new verification record with a new verification_uuid to upload docs to. The original record will remain in failed.
• Not a requirement, but you may consider reviewing the PII provided for the entity during /register and updating anything that may be incorrect.
• If the doc is incomplete in some way, such as missing a signature, you will be prompted to upload the doc again.
• If the doc provided does not provide enough further verification to pass KYC, you will be prompted to upload a different doc.
• Priority estimates an approximately 24 hour turnaround time for reviewing uploaded docs.
• There is NOT a limit on the number of times the same or different docs can be uploaded for a single verification record, but each entity is limited to a single verification record. If an entity has already begun the KYC process, you will receive an error if you call /kyc again.

Responses