---
title: "GET /agents/{agentId}/a2a/tasks"
method: GET
path: "/agents/{agentId}/a2a/tasks"
---

# GET /agents/{agentId}/a2a/tasks

`GET /agents/{agentId}/a2a/tasks`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/agents/{agentId}/a2a/tasks`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `agentId` string, required: ID of the agent to list tasks for

## Query parameters

- `status` 'submitted' | 'working' | 'input_required' | 'completed' | 'failed' | 'canceled': Filter by task status
- `cursor` string: Cursor for pagination
- `limit` integer: Maximum items per page

## Response `200`

OK

- object: Paginated list of A2A tasks
  - `items` object[], required: Array of matching A2A tasks
    - `id` string, required: Unique task identifier
    - `agentId` string, required: ID of the receiving agent
    - `orgId` string, required: Organization that owns the receiving agent
    - `fromDid` string, required: Sender DID
    - `toDid` string, required: Receiver DID
    - `type` string, required: Task type
    - `status` 'submitted' | 'working' | 'input_required' | 'completed' | 'failed' | 'canceled', required: Current status of the A2A task
    - `input` object, required: Task input payload
    - `output` object, nullable, required: Task output payload
    - `error` object, nullable, required: Error details if task failed
      - `code` string, required: Error code
      - `message` string, required: Error message
    - `history` object[], required: Status change history
      - `status` 'submitted' | 'working' | 'input_required' | 'completed' | 'failed' | 'canceled', required: Current status of the A2A task
      - `message` string: Human-readable status message
      - `timestamp` string, date-time, required: ISO-8601 timestamp of the event
    - `createdAt` string, date-time, required: Task creation timestamp
    - `updatedAt` string, date-time, required: Last update timestamp
  - `nextCursor` string, nullable, required: Cursor for fetching the next page

---

[API](https://skmtc.dev/useanima/apis/anima-api.md) · [All operations](https://skmtc.dev/useanima/apis/anima-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useanima/apis/anima-api/revisions/aaa148188980?raw)