Skip to main content
GET
/
v1
/
kyb
/
applicants
curl https://api.vouchmark.com/v1/kyb/applicants \
  -H "Authorization: Bearer $TOKEN"

{
  "success": true,
  "data": [
    {
      "id": "app_aBcD...",
      "widgetId": "wgt_aBcD...",
      "environment": "live",
      "status": "created",
      "subject": {
        "businessName": "Acme Trading Ltd",
        "registrationNumber": "RC123456",
        "tin": "12345678-0001",
        "email": "admin@acme.com",
        "phone": "+2348012345678",
        "jurisdiction": "NG",
        "industry": "fintech"
      },
      "referenceId": "your_ref_123",
      "riskScore": null,
      "decisionReason": null,
      "moduleOrder": ["business_profile", "cac_verification", "tin_verification"],
      "totalSpentKobo": 0,
      "startedAt": null,
      "submittedAt": null,
      "decidedAt": null,
      "createdAt": "2026-06-01T10:00:00Z",
      "updatedAt": "2026-06-01T10:00:00Z"
    }
  ]
}
Returns every applicant created under your account as a flat array of applicant objects. There are no query filters and no pagination. To list applicants for a single widget, call GET /v1/kyb/widgets/{id}/applicants instead — it returns the same { "success": true, "data": [<applicant>] } shape, scoped to that widget. Requires Authorization: Bearer $TOKEN. 
curl https://api.vouchmark.com/v1/kyb/applicants \
  -H "Authorization: Bearer $TOKEN"

{
  "success": true,
  "data": [
    {
      "id": "app_aBcD...",
      "widgetId": "wgt_aBcD...",
      "environment": "live",
      "status": "created",
      "subject": {
        "businessName": "Acme Trading Ltd",
        "registrationNumber": "RC123456",
        "tin": "12345678-0001",
        "email": "admin@acme.com",
        "phone": "+2348012345678",
        "jurisdiction": "NG",
        "industry": "fintech"
      },
      "referenceId": "your_ref_123",
      "riskScore": null,
      "decisionReason": null,
      "moduleOrder": ["business_profile", "cac_verification", "tin_verification"],
      "totalSpentKobo": 0,
      "startedAt": null,
      "submittedAt": null,
      "decidedAt": null,
      "createdAt": "2026-06-01T10:00:00Z",
      "updatedAt": "2026-06-01T10:00:00Z"
    }
  ]
}