---
title: "List the user's checklists"
method: GET
path: "/checklists.{format}"
tags: ["Checklists"]
---

# List the user's checklists

`GET /checklists.{format}`

Sorted the same way as in the Checkvist UI (most recently updated first by default).

## Path parameters

- `format` 'json' | 'xml', required

## Query parameters

- `archived` boolean
- `order` 'id:asc' | 'id:desc' | 'updated_at:asc'
- `skip_stats` boolean
- `with_inbound_email` boolean

## Response `200`

Array of checklists.

- Checklist[]
  - `id` integer
  - `name` string
  - `public` boolean — True for a checklist that anyone can read without authentication.
  - `role` 1 | 2 | 3 — 1 - author, 2 - writer, 3 - reader.
  - `updated_at` string — Time of the last update (includes task updates, excludes comments). See **Timestamp format** in the introduction.
  - `task_count` integer — Total number of leaf tasks.
  - `task_completed` integer — Number of completed leaf tasks.
  - `read_only` boolean — True if the user's access to this list is read-only.
  - `archived` boolean — True if the user archived this list.
  - `inbound_email` string — The list's inbound "email to list" address (send mail here to add tasks to the list; the same address shown in the web UI). The address embeds the user's Remote API key, so regenerating that key changes the `inbound_email` of every list.
  - `tags` object — (JSON only) Map of tag name => isPrivate.
  - `tags_as_text` string — (JSON only) Comma-separated list of tag names.

---

[API](https://skmtc.net/checkvist/apis/checkvist-open-api.md) · [All operations](https://skmtc.net/checkvist/apis/checkvist-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/checkvist/checkvist-open-api/revisions/94fd298acebe/schema)