Document Verification

id_document

Verify government-issued identity documents such as passports, national IDs, and driver's licenses across 47+ African countries.

Endpoint

Verification Mode

Generates a hosted verification URL to send to the customer. The customer completes verification on the hosted page.

Request Parameters (input_data)

Sample Request

curl -X POST https://api.verifyafrica.io/api/verifications/requests/ \
  -H "X-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "is_test": false,
  "verification_type": "id_document",
  "method_type": "onsite",
  "input_data": {
    "country": "NG",
    "language": "EN",
    "email": "customer@example.com",
    "ttl": 60,
    "ekyc": {
      "allow_fallback": "0"
    }
  }
}'

Expected Response Structure

{
  "status": "success",
  "data": {
    "id": "ver_abc123",
    "verification_type": "id_document",
    "status": "completed",
    "created_at": "2025-01-15T10:30:00Z",
    "verification_url": "https://verify.shufti.com/verification/abc123"
  }
}

Response Codes