---
title: "List the account's verification requests"
method: GET
path: "/v1/requests"
---

# List the account's verification requests

`GET /v1/requests`

## Request

- Base URL: `https://api.lumethic.com`
- URL: `https://api.lumethic.com/v1/requests`
- Auth: `OAuth2PasswordBearer` (a scheme the document does not define)

List requests newest first, optionally filtered by derived status.

## Query parameters

- `offset` integer
- `size` integer
- `status` 'open' | 'closed' | 'expired': Derived status of a verification request. ``open`` and ``closed`` are stored; ``expired`` is ``open`` past ``expires_at`` and is never written to the row.

## Headers

- `X-API-Key` string, nullable

## Response `200`

Successful Response

- VerificationRequestListResponse
  - `items` VerificationRequestResponse[], required
    - `id` string, uuid, required
    - `subject` string, required
    - `instructions` string, nullable, required
    - `mode` 'existing_original' | 'capture', required: How the provider answers a request: an uploaded camera original, or a capture with Lumethic Capture.
    - `status` 'open' | 'closed' | 'expired', required: Derived status of a verification request. ``open`` and ``closed`` are stored; ``expired`` is ``open`` past ``expires_at`` and is never written to the row.
    - `expires_at` string, date-time, required
    - `closed_at` string, date-time, nullable, required
    - `max_submissions` integer, required
    - `submission_count` integer, required: Accepted uploads so far (counted, never stored).
    - `share_with_provider` boolean, required
    - `token` string, required: Bearer secret: anyone holding it can open the landing page and upload to this request until it closes, expires or fills. Returned on every owner read; listing requests exposes every open link of the account.
    - `url` string, required: The landing page link (and the QR code's content): {FRONTEND_URL}/r/{token}.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `total` integer, required: Total number of requests matching the filter
  - `offset` integer, required
  - `size` integer, required
  - `total_pages` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/lumethic/apis/lumethic-integration-api.md) · [All operations](https://skmtc.dev/lumethic/apis/lumethic-integration-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lumethic/apis/lumethic-integration-api/revisions/fdafea3a491e?raw)