---
title: "List the caller's tasks"
method: GET
path: "/v1/tasks"
tags: ["tasks"]
---

# List the caller's tasks

`GET /v1/tasks`

## Request

- Base URL: `https://api.beatra.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.beatra.ai/v1/tasks`
- Auth: none declared

Returns TaskSummary by default. Use `?expand=output,usage,billing,callback,input` or `?expand=all` to return full TaskEnvelope items.

## Query parameters

- `status` string[], nullable
- `capability` string[], nullable
- `created_after` string, date-time, nullable
- `created_before` string, date-time, nullable
- `limit` integer
- `cursor` string, nullable
- `order` 'asc' | 'desc'
- `expand` string, nullable: Comma-separated fields to include: output,usage,billing,callback,input,all

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- AppApiV1SchemasTasksTaskListResponse: List response wrapper. Uses TaskSummary by default. Clients can opt-in to richer detail via `?expand=output,usage,billing,callback,input` or `?expand=all`. When expand is in effect, items become full TaskEnvelope.
  - `object` 'list'
  - `data` object[], required: TaskSummary[] by default; TaskEnvelope[] with expand
  - `next_cursor` string, nullable
  - `has_more` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/beatra/apis/agent-service-api.md) · [All operations](https://skmtc.dev/beatra/apis/agent-service-api/llms.txt) · [OpenAPI document](https://skmtc.dev/beatra/apis/agent-service-api/revisions/58e440556498?raw)