---
title: "Check eligibility for a single document"
method: GET
path: "/api/v1/eligibility/single"
tags: ["Eligibility"]
---

# Check eligibility for a single document

`GET /api/v1/eligibility/single`

Verifies whether a given employee document is eligible within the authenticated company group. Returns availability status and, when eligible, details about the associated store and holder.

## Query parameters

- `document_number` string, required
- `document_kind` 'cpf', required

## Response `200`

Eligibility result returned

- object
  - `available` boolean, required — Whether the document is eligible in this company group
  - `kind` string, required — Role of the eligible person (holder or dependent)
  - `store_document_kind` string, nullable — Identifier type of the matched company (store)
  - `store_document_number` string, nullable — Identifier of the matched company (store)
  - `holder_document_kind` string, nullable — Identifier type of the holder (when kind is dependent)
  - `holder_document_number` string, nullable — Identifier of the holder (when kind is dependent)

## Other responses

- `401` — Missing or invalid token

---

[API](https://skmtc.net/totalpass/apis/token-use.md) · [All operations](https://skmtc.net/totalpass/apis/token-use/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/totalpass/token-use/revisions/bc65b4950c7e/schema)
