> ## 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 widgets

> Retrieve all KYB widgets for the authenticated account.

Returns every widget you've created as a flat array. Each entry is the full widget object, including its complete `config` and `embedLinkToken`.

Requires `Authorization: Bearer $TOKEN`.

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

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": [
      {
        "id": "wgt_aBcD...",
        "name": "Acme KYB",
        "status": "live",
        "environment": "live",
        "templateId": "fintech",
        "config": {
          "branding": { "brandName": "FinCo", "...": "..." },
          "modules": { "business_profile": { "enabled": true, "required": true }, "...": "..." },
          "flow": { "order": ["business_profile", "cac_verification"], "...": "..." },
          "security": { "allowedDomains": [], "...": "..." },
          "risk": { "tier": "standard", "...": "..." },
          "notifications": { "...": "..." }
        },
        "embedLinkToken": "elt_...",
        "createdAt": "2026-06-01T10:00:00Z",
        "updatedAt": "2026-06-01T10:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>

`data` is a flat array of widget objects — there is no `widgets` wrapper, `total`, or pagination. See [Get widget](/api-reference/onboarding/get-widget) for the full shape of each `config` section.