> ## Documentation Index
> Fetch the complete documentation index at: https://www.plain.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch tasks

<Snippet file="graphql/sdk-note.mdx" />

We provide three methods for fetching tasks:

1. [Get tasks](#get-tasks) — paginated collection
2. [Get task by ID](#get-task-by-id)
3. [Get task by ref](#get-task-by-ref) — `ref` is the short human-readable identifier shown in the Plain app (e.g. `T-123`)

These queries require the following permissions:

* `task:read`

## Get tasks

<Snippet file="graphql/get-tasks.mdx" />

## Get task by ID

<Snippet file="graphql/get-task-by-id.mdx" />

## Get task by ref

<Snippet file="graphql/get-task-by-ref.mdx" />