---
title: "List all checks"
method: GET
path: "/v1/checks"
tags: ["Checks"]
---

# List all checks

`GET /v1/checks`

Returns a list of all checks created in your Dotfile workspace.

---

#### See also  
Learn more about [Checks](./checks-guide)  
Learn more about [Filtering, Sorting and Pagination](./filtering-sorting-and-pagination)

## Query parameters

- `individual_id` string
- `company_id` string
- `status` 'in_progress' | 'need_review' | 'processing' | 'approved' | 'rejected' | 'expired'
- `type` 'id_verification' | 'id_document' | 'aml' | 'company_monitoring' | 'document' | 'ekyc' | 'electronic_signature' | 'fraud_database' | 'online_reputation'
- `exclude_internal` boolean
- `include_not_relevant` boolean
- `created_at` string — Date (`yyyy-MM-dd` eg `2023-01-31`) or date time (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`) in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
- `updated_at` string — Date (`yyyy-MM-dd` eg `2023-01-31`) or date time (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`) in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
- `last_activity_at` string — Date (`yyyy-MM-dd` eg `2023-01-31`) or date time (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`) in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
- `sort` string
- `page` number
- `limit` number

## Response `200`

List of checks created in the workspace

**ℹ️ Click to see full payload**

- CheckList
  - `data` Check[], required
    - `id` string, uuid, required
    - `individual_id` string, nullable, required
    - `company_id` string, nullable, required
    - `is_internal` boolean, required
    - `status` 'in_progress' | 'need_review' | 'processing' | 'approved' | 'rejected' | 'expired', required — ℹ️ Check status `expired` is deprecated and will be removed Q1'25. It will be replaced with an expired flag.
    - `type` 'id_verification' | 'id_document' | 'aml' | 'company_monitoring' | 'document' | 'ekyc' | 'electronic_signature' | 'fraud_database' | 'online_reputation', required
    - `subtype` string, nullable, required — Contains the `subtype` for some check `type`: - `document`: Currently contains `"document_type:{document_type_key}"` - `electronic_signature`: Contains `"document_template:{document_template_key}"` - For all other check type, always contains `null`
    - `document_type_key` string — Set only for `document` Check with the document type key.
    - `created_at` string, date-time, required — Creation date Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
    - `updated_at` string, date-time, required — Latest update date Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
    - `last_activity_at` string, date-time, required — Latest activity date Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
  - `pagination` Pagination, required
    - `page` number, required — Current page number (defined in query parameter)
    - `limit` number, required — Item count per page (defined in query parameter)
    - `count` number, required — Total items count

## Other responses

- `400` — The request is either malformed or contain invalid parameters. - One or multiple filtering parameters might be malformed. Make sure to use a supported operator and value for each filter. - If specified, make sure the value of the `page` or `limit` query parameter are valid. - Value of the `sort` parameter is invalid. Make sure the field name is supported, the sorting order is correctly specified, and a same field is not used multiple times for sorting.

---

[API](https://skmtc.dev/dotfile/apis/api-specifications.md) · [All operations](https://skmtc.dev/dotfile/apis/api-specifications/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dotfile/api-specifications/revisions/36393567057b/schema)