Get verification status

Get verification status

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

Example Request

curl

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
}