---
title: "Finds checklists matching the search criteria and optionally creates a checklist if it doesn't exist."
method: GET
path: "/api/checklist/find"
tags: ["Checklist"]
---

# Finds checklists matching the search criteria and optionally creates a checklist if it doesn't exist.

`GET /api/checklist/find`

## Request

- Base URL: `https://app.checkflow.io` (the document declares no server; this is the origin it was published from)
- URL: `https://app.checkflow.io/api/checklist/find`
- Auth: none declared

If you do not know the key for the template your checklists are derived from use - GET: api/template/templates

Sample requests:

    GET: api/checklist/find?templateKey=0e7ad584-7788-4ab1-95a6-ca0a5b444cbb
    GET: api/checklist/find?templateKey=0e7ad584-7788-4ab1-95a6-ca0a5b444cbb&checklistName=My%20Checklist
    GET: api/checklist/find?templateKey=0e7ad584-7788-4ab1-95a6-ca0a5b444cbb&checklistName=My%20Checklist&tag=Urgent
    GET: api/checklist/find?templateKey=0e7ad584-7788-4ab1-95a6-ca0a5b444cbb&tag=Urgent&status=INPROGRESS
    GET: api/checklist/find?templateKey=0e7ad584-7788-4ab1-95a6-ca0a5b444cbb&checklistName=My%20Checklist&createIfNotExists=true

## Query parameters

- `templateKey` string
- `checklistName` string
- `tag` string
- `status` string
- `createIfNotExists` boolean
- `pageSize` integer
- `pageNumber` integer

## Headers

- `X-API-VERSION` string
- `X-API-KEY` unknown

## Response `200`

Returns the matching checklists

## Other responses

- `401`: If the API Key could not be validated
- `404`: If no checklists are found

---

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