> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

---
title: "List tasks"
description: "Retrieve all tasks for the authenticated user. Supports filtering by completion status."
api: "GET /tasks"
gridGap: 30
---

<Aside full>

<RequestExample>

```bash lines=false
curl -X GET "https://api.example.com/v1/tasks" \
  -H "Authorization: Bearer <token>"
```

</RequestExample>

<ResponseExample>

```json lines=false
[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "title": "Set up Holocron docs",
    "completed": false,
    "createdAt": "2026-01-15T09:00:00Z"
  }
]
```

</ResponseExample>

</Aside>

<OpenAPIEndpoint {...{"method":"get","path":"/tasks","summary":"List tasks","description":"Retrieve all tasks for the authenticated user. Supports filtering by completion status.","parameters":[{"name":"completed","in":"query","description":"Filter by completion status","schema":{"type":"boolean"}},{"name":"limit","in":"query","description":"Maximum number of tasks to return","schema":{"type":"integer","default":20,"minimum":1,"maximum":100}}],"responses":[{"status":"200","description":"A list of tasks","schema":{"type":"array","items":{"type":"object","required":["id","title","completed"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique task identifier"},"title":{"type":"string","description":"Short description of the task","minLength":1,"maxLength":200},"completed":{"type":"boolean","description":"Whether the task is done","default":false},"createdAt":{"type":"string","format":"date-time","description":"When the task was created"}}}},"example":[{"id":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","title":"Set up Holocron docs","completed":false,"createdAt":"2026-01-15T09:00:00Z"}]}],"security":[{"name":"bearerAuth","type":"http","scheme":"bearer","in":"header","description":"JWT token from /auth/login"}],"servers":[{"url":"https://api.example.com/v1","description":"Production"}]}} />

---

*Powered by [holocron.so](https://holocron.so)*