Verifications

Each authorized user is assigned to a single merchant/service provider, granting the merchant access to all user verifications.

Verification Status

Status	Description
STARTED	Mobile app has invoked SehaciSDK.prepare()
IN_PROGRESS	Encrypted mDL has been sent to the Sehaci Verification Service
PASSED	Document verified and valid
FAILED	Document verification failed

List Verifications

GET /verifications

Retrieve a list of all verifications for the merchant.

Headers

Name	Value
Content-Type	application/json
X-Api-Key	API_KEY

URL Params

Name	Type	Description
page	number	Page of the list
per_page	number	Items per page
status	string	Filter by verification status
issuer	string	Filter by issuer

Response

200

{
   "verifications": [
      {
         "verification_id": "f7a8b9c0-d1e2-f3a4-b5c6-d7e8f9a0b1c2",
         "name_short": "Ethan Harris",
         "status": "PASSED",
         "issuer_description": "Colorado DMV",
         "merchant_config_description": "Verification",
         "last_updated_at": "2024-07-03 19:10:00"
      },
      ...
   ],
   "page": 2,
   "per_page": 5,
   "total_items": 36,
   "total_pages": 8,
   "prev": "http://verify-api.sehaci.com/verifications?page=1",
   "next": "http://verify-api.sehaci.com/verifications?page=3"
}

400

Verification Details

GET /verification/{verification_id}

Retrieve the details of a specific verification.

Headers

Name	Value
Content-Type	application/json
X-Api-Key	API_KEY

Response

200

{
  "verification_id": "a5c7d8e9-f0a1-b2c3-d4e5-f6a7b8c9d0e1",
  "created_at": "2024-06-25T11:00:00",
  "last_updated_at": "2024-06-25T11:10:00",
  "name_short": "Sophia Davis",
  "status": "FAILED",
  "verified_at": "2024-06-25T11:05:00",
  "merchant_config": {
    "merchant_config_id": "e67bea25-de89-4c92-89e7-9b6a8324a7fa",
    "merchant_config_description": "Identity check + photo + video"
  },
  "issuer": {
    "issuer_id": "0C",
    "issuer_description": "Arizona DOT",
    "issuer_chain_valid": true,
    "issuer_signature_exists": true,
    "issuer_signature_valid": true,
    "issuer_signature_value": "f1e2d3c4b5a6f1e2d3c4b5a6f1e2d3c4"
  },
  "device": {
    "device_signature_exists": true,
    "device_signature_valid": true,
    "device_signature_value": null
  },
  "verified_data_elements": [
    "given_name",
    "family_name",
    "document_number",
    "expiry_date",
    "document_issue_date",
    "portrait",
    "resident_country",
    "birth_date",
    "age_in_years"
  ]
}

400