Get Verification Status

Get verification status

http://localhost:8009/api/v1/modular/status/69642fd7ee5d8e12413a31e6


Example Request

curl --location 'http://localhost:8009/api/v1/modular/status/69642fd7ee5d8e12413a31e6'

Example Response Body

{
  "verification_id": "69689455a8af0805a9fe55e8",
  "reference": "VRF_fc1357d5-726a-4831-b5bc-5c7abe05f0ba",
  "user": {
    "id": "6968923e006455277cf86d21",
    "user_ref": "USR_05437b08-198b-4e56-a06b-b66e328c31a1",
    "email": "[email protected]",
    "phone": "2348113372866"
  },
  "country": "NG",
  "status": "pending",
  "overall_status": "pending",
  "verification_url": "https://your-frontend-url.com/modular/verify/69689455a8af0805a9fe55e8",
  "callback": "https://your-app.com/kyc-callback",
  "redirect": "https://your-app.com/dashboard",
  "todo": [
    "bvn",
    "nin",
    "phone",
    "liveliness",
    "address_verification",
    "bio",
    "disclaimer",
    "tin",
    "cac",
    "aml_check",
    "sanction_list"
  ],
  "completed_checks": 0,
  "total_checks": 11,
  "check_statuses": [
    { "check_type": "bvn", "status": "pending", "result": null },
    { "check_type": "nin", "status": "pending", "result": null },
    { "check_type": "phone", "status": "pending", "result": null },
    { "check_type": "liveliness", "status": "pending", "result": null },
    { "check_type": "address_verification", "status": "pending", "result": null },
    { "check_type": "bio", "status": "pending", "result": null },
    { "check_type": "disclaimer", "status": "pending" },
    { "check_type": "tin", "status": "pending", "result": null },
    { "check_type": "cac", "status": "pending", "result": null },
    { "check_type": "aml_check", "status": "pending", "result": null },
    { "check_type": "sanction_list", "status": "pending", "result": null }
  ],
  "branding": {
    "bg_color": "#1a1a2e",
    "text_color": "#ffffff",
    "button_color": "#00ff88",
    "brand_logo": "https://example.com/logo.png",
    "brand_name": "My Company"
  },
  "created_at": "2026-01-15T07:16:38.058Z",
  "expires_at": "2026-01-22T07:16:37.881Z",
  "completed_at": null
}

Did this page help you?