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"
}
]
}
Onboarding (KYB)
List applicants
List every applicant across all your widgets.
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"
}
]
}
⌘I