---
title: "List task history for the authenticated API key"
method: GET
path: "/api/v1/jobs"
tags: ["Tasks"]
---

# List task history for the authenticated API key

`GET /api/v1/jobs`

## Request

- Base URL: `https://api.popnow.ai`
- URL: `https://api.popnow.ai/api/v1/jobs`
- Auth: HTTP bearer

Returns only visible tasks created by this API key, newest first by
createdAt and taskId. Scope is this API key: tasks created by other keys on the same account, and generations started directly in the web console (which use no API key), are not included. For an account-wide view, use the console's usage page. The list contains metadata only;
use recordInfo for a selected task's result. No input, output, signed
media URL, or internal processing detail is included.
Dates form a UTC half-open interval [from,to), up to 92 days.
Default to is tomorrow in UTC; omitted from is seven days before to.
Keep all filters, including explicit from/to dates, unchanged while
paginating with nextCursor. Pages read live state, not a frozen snapshot.
Unknown, duplicate, or empty query parameters are rejected. Queries
have a five-second server budget and return 503 on timeout.

## Query parameters

- `from` string, date
- `to` string, date
- `state` 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled' | 'expired'
- `model` string
- `limit` integer
- `cursor` string

## Response `200`

Current-key task summaries without prompt or result payloads.

- APIKeyTaskListEnvelope
  - `code` 200, required
  - `msg` 'success', required
  - `request_id` string, required: Correlation identifier. Include it in support requests.
  - `data` APIKeyTaskListResponse, required
    - `items` APIKeyTaskItem[], required
      - `taskId` string, required
      - `requestId` string: The `X-Request-Id` of the request that created this task. Chat calls (`/v1/chat/completions`, `/v1/responses`, `/v1/messages`, Gemini) can be matched to their task with it, or with the `X-PopNow-Task-Id` response header. Omitted when no request id was recorded.
      - `model` string, required: Model call name, `<publisher>/<model>/<task>`.
      - `state` 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled' | 'expired', required
      - `cost` string, required: Decimal USD amount encoded as a string to avoid binary floating-point loss.
      - `credits` integer, required: The same amount as `cost`, in credits, rounded up to a whole credit.
      - `exactCredits` string, required: The same amount as `credits`, not rounded, as a decimal string (for example `"0.0731"`). Chat calls are charged their actual token usage in fractional credits, so use this field to see what a chat call cost.
      - `settled` boolean, required
      - `createdAt` string, date-time, required
      - `deadlineAt` string, date-time, required
      - `completedAt` string, date-time
    - `hasMore` boolean, required
    - `nextCursor` string: Present only when hasMore is true.

## Other responses

- `400`: Invalid JSON, query, callback URL, model input, or media declaration. Invalid callBackUrl values return code 400 and msg "Invalid callback URL" with request_id. Submitted hosts, IP addresses, and DNS diagnostics are not echoed.
- `401`: Missing, malformed, expired, revoked, or otherwise invalid API key.
- `403`: Account, model, API-key, IP, or region authorization failed.
- `429`: Account-level request limit exceeded.
- `500`: Internal failure. Details are not exposed; report `request_id` to support.
- `503`: HTTP 503 carries one of three business codes. `50301`: no usable deployment or effective customer price exists for the selected model. `503`: a dependency is temporarily unavailable; retry after the `Retry-After` header when it is present. `50302`: a synchronous generation failed upstream and the charge was refunded. Nothing was charged, but send the retry with a **new** `Idempotency-Key`: reusing the original one replays the recorded failure instead of generating again.

---

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