---
title: "Get a checklist"
method: GET
path: "/checklists/{checklist_id}.{format}"
tags: ["Checklists"]
---

# Get a checklist

`GET /checklists/{checklist_id}.{format}`

## Path parameters

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

## Query parameters

- `with_inbound_email` boolean

## Response `200`

The requested checklist.

- 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)