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

# List Tasks

> Get tasks for the authenticated user

<Note>This endpoint requires authentication.</Note>

## Query Parameters

<ParamField query="status" type="string">
  Filter by status: `open`, `in_progress`, `completed`, `cancelled`
</ParamField>

## Response

Array of tasks.

<ResponseField name="data" type="array">
  <Expandable title="Task object">
    <ResponseField name="id" type="string">
      Task UUID
    </ResponseField>

    <ResponseField name="title" type="string">
      Task title
    </ResponseField>

    <ResponseField name="description" type="string">
      Task description
    </ResponseField>

    <ResponseField name="priority" type="integer">
      Priority (1-5)
    </ResponseField>

    <ResponseField name="status" type="string">
      Current status
    </ResponseField>

    <ResponseField name="dueDate" type="string">
      Due date
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      Creation timestamp
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.hitler.app/api/tasks?status=open" \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```

  ```typescript TypeScript theme={null}
  const tasks = await api.getTasks({ status: "open" });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "task-uuid-1",
      "title": "Review Q4 budget proposal",
      "description": null,
      "priority": 2,
      "status": "open",
      "dueDate": "2024-01-20T17:00:00.000Z",
      "createdAt": "2024-01-15T10:35:00.000Z"
    },
    {
      "id": "task-uuid-2",
      "title": "Prepare meeting notes",
      "description": "For the client call on Wednesday",
      "priority": 3,
      "status": "open",
      "dueDate": null,
      "createdAt": "2024-01-14T09:00:00.000Z"
    }
  ]
  ```
</ResponseExample>