Run this endpoint after /register and /kyc. Use /get_verifications/<verification_uuid> for further details on a single verification record.

🚧

Advanced KYC ONLY

Only use this endpoint if you are utilizing the new Advanced KYC. Otherwise, use /check_kyc.

📘

Timing and Webhooks

Please make use of our webhooks so that you are notified when changes have been made. On average it takes about 33 seconds for an ID verification to complete, but can take less or more time.

If a verification status stays in review or documents_required for 30 days, the evaluation will expire and the status will transition to failed, and this will count against the max number of KYC attempts (2 total per entity).

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": "handle.silamoney.eth", //required
    "user_handle":"user.silamoney.eth", //required
    "version": "0.2", 
    "reference": "<your unique id>"
  }
}

***

HTTP/1.1 200 OK

{
  "success": True,
  "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

Reason Tags

Tags returned by Alloy explaining the verification result. Please be aware tags are specific to KYC or KYB, not both.

Responses