> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vouchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List applicants

> List every applicant across all your widgets.

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`.

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.vouchmark.com/v1/kyb/applicants \
    -H "Authorization: Bearer $TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "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"
      }
    ]
  }
  ```
</ResponseExample>