---
title: "List your APIs"
method: GET
path: "/dispatch/tasks"
tags: ["Dispatch"]
---

# List your APIs

`GET /dispatch/tasks`

List all dispatch tasks for the current user, with optional status filter and pagination.

## Query parameters

- `status` string
- `limit` integer
- `offset` integer

## Response `200`

List of tasks

- TaskListResponse
  - `tasks` TaskDetail[]
    - `id` string
    - `url` string
    - `task` string, nullable
    - `status` 'queued' | 'running' | 'needs_input' | 'completed' | 'failed' | 'cancelled' — Task lifecycle state. Poll until it reaches a terminal state: completed, failed, or cancelled.
    - `iteration` integer, nullable
    - `user_input_prompt` object, nullable — Present when status is 'needs_input' — the question(s) the agent needs answered. Respond via POST /dispatch/{task_id}.
    - `result_scraper_id` string, nullable — Set on completion — the scraper_id used to execute endpoints.
    - `result_marketplace_id` string, nullable
    - `error` string, nullable — Set when status is 'failed'.
    - `created_at` string, nullable
    - `updated_at` string, nullable
    - `completed_at` string, nullable
    - `parent_task_id` string, nullable
    - `extends_scraper_id` string, nullable
    - `revision_type` string, nullable
    - `auth_enabled` boolean — True if this API was built against a site that requires login.
    - `source` 'built' | 'subscribed' | 'forked' — How the user acquired this API.
    - `contributes_to_marketplace` boolean
    - `progress` object — Live build progress while status is 'running' (stage, headline, per-endpoint status, log).
    - `marketplace_apis` object, nullable
    - `existing_marketplace_apis` object, nullable
    - `generated_api` GeneratedAPI
      - `marketplace_id` string
      - `scraper_id` string
      - `name` string
      - `description` string, nullable
      - `source_url` string
      - `execution_base_url` string — Base URL for executing endpoints: {execution_base_url}/{endpoint_name}
      - `endpoints` EndpointSpec[]
        - `method` string — HTTP method (GET, POST, etc.)
        - `endpoint_name` string — Endpoint path segment
        - `description` string
        - `input_params` object
        - `return_schema` object
        - `initiates_session` boolean — True for a login endpoint that returns a session — see Authenticated APIs.
  - `total` integer

---

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