---
title: "List tasks (paginated)"
method: GET
path: "/api/v1/tasks"
tags: ["tasks"]
---

# List tasks (paginated)

`GET /api/v1/tasks`

Returns a paginated list of tasks with optional filters by status, taskType, or operatorId.

## Query parameters

- `page` number
- `limit` number
- `status` string
- `taskType` string
- `operatorId` string
- `agentId` string

## Response `200`

Paginated task list

- object
  - `data` object[]
    - `id` string
    - `taskType` string
    - `status` string
    - `agentId` string
    - `model` string, nullable
    - `provider` string, nullable
    - `latencyMs` number, nullable
    - `ipfsCid` string, nullable
    - `stateRoot` string, nullable
    - `verificationStatus` string, nullable
    - `verificationScore` number, nullable
    - `verificationProof` string, nullable — TX hash from on-chain verification anchor
    - `verificationBasescanUrl` string, nullable
    - `attestationUid` string, nullable — EAS Omni-Stamp UID (bytes32 hex)
    - `easscanUrl` string, nullable — EASScan deep link
    - `createdAt` string, date-time
    - `completedAt` string, date-time, nullable
  - `total` number
  - `page` number
  - `limit` number
  - `totalPages` number

## Changes

- **2026-04-10** `280a966f6587` — 5 info
  - added the new optional `query` request parameter `agentId`
  - added the optional property `data/items/attestationUid` to the response with the `200` status
  - added the optional property `data/items/easscanUrl` to the response with the `200` status
  - added the optional property `data/items/verificationBasescanUrl` to the response with the `200` status
  - …1 more
- **2026-03-14** `cf616c4f534e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/humbleaf/apis/agentchain-prior-api/changes/api/v1/tasks/get.md)

---

[API](https://skmtc.dev/humbleaf/apis/agentchain-prior-api.md) · [All operations](https://skmtc.dev/humbleaf/apis/agentchain-prior-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/humbleaf/agentchain-prior-api/revisions/33dd194c5572/schema)