/get_verifications/<verification_uuid>

Advanced KYC endpoint that returns a single, specified verification record.

Run this endpoint after /register and /kyc. For a full list of verification records for an entity, call /get_verifications.

🚧

Advanced KYC ONLY

Only use this endpoint if you are utilizing the new Advanced 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 be failed.

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/<verification_uuid> 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,
  'status': 'SUCCESS',
  'message': 'User has passed ID verification!',
  'response_time_ms': '171',
  'reference': <provided reference_id>,
  'verification_id': <provided verification uuid>,
  'entity_type': 'individual' or 'business',
  'verification_status': 'passed',
  'flow': <uuid of KYCFlow>,
  'checks_performed': [KYC options selected],
  'requested_at': 1592339985,
  'updated_at': 1592340016,
  'parent_verification': <verification_uuid of parent verification if member of KYB else null>,
  'reasons': {
    <entity_handle>: [<List of reasons providing rationale for the outcome, this will vary but should not be empty>]
  }
}

Request Attributes

KeyTypeDescription
headerJSON objectRequired.

Required keys:

created - Unix epoch timestamp in seconds. Must not be future-dated and must not be dated more than 5 minutes in the past.
app_handle - your app handle
user_handle - the user_handle to pull verification data for.

Optional keys:

reference: Can be any value for your own reference. If not provided, one will be assigned.
version: Cannot be null if key is present. Valid values: 0.2, v0.2, V0.2
verification_uuidstringRequired.

The UUID of the verification record you want to see. Can be found in responses from either /kyc or /get_verifications.

Verification Statuses

Verification StatusDescription
'unverified'Entity has not had a KYC evaluation
'passed'Entity has passed KYC
'pending'An entity's KYC evaluation is in progress
'review'Under manual review by Sila
'failed'Entity has failed KYC
'member_failed'Business member failed KYC. KYB will need to be re-requested to begin a new verification attempt (2 attempts max)
'member_review'Happens when a business member is under manual review. Documents may or may not be required for verification
'member_pending'A business member's KYC evaluation is in progress
'documents_required'Review entity PII; upload document if reviewing PII doesn't pass entity
'documents_received'Documents were received but not reviewed
'webhook_pending'Waiting for a webhook response from a KYC provider

Reason Tags

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

KYC or KYBTag
KYCSSN Miskey
KYCSSN Warning
KYCSSN Velocity
KYCSSN Not Verified
KYCKYC SSN Match
KYCKYC Name Match
KYCKYC DOB Match
KYCKYC Address Match
KYCKYC Review
KYCDOB Miskey
KYCDOB Not Verified
KYCFraud Review
KYCDenied Fraud
KYCPhone Warning
KYCFraud Warning
KYCFraud Risk
KYCEmail Warning
KYCEmail Velocity
KYCAddress Warning
KYCAddress Not Verified
KYCVelocity Warning
KYCWatchlist Review
KYCOFAC Match
KYCName Not Verified
KYBAddress Not Matched
KYBAddress Matched
KYBFEIN Unmatched
KYBFEIN Found
KYBCompany Name Verified
KYBCompany Name Not Matched
KYBMiddesk Pending
KYBWatchlist Warning
KYBSecretary of State Warning
KYBSecretary of State Match

Responses

Status CodeSuccess AttributeDescription
200true
404falseRequested verification_uuid not found.

"No KYC verification record can be found matching id {_uuid}"