List jobs

GET /v1/jobs returns your parent jobs, newest first, with cursor pagination. Reads are owner-scoped: a restricted sk_* key sees only its own jobs.

This endpoint lists parents only. To read a single parent’s rollup or one child’s Envelope, use GET /v1/jobs/:id.

Query parameters

limit

integer

default:"20"

Page size, 1–100.

state

string

Filter by parent lifecycle state: queued, processing, completed, partial, failed, canceled, or expired.

surface

string

Filter to parents that include a child on this surface (e.g. chatgpt).

cursor

string

Opaque cursor from a previous page’s nextCursor. Omit for the first page.

Request

curl "https://api.aisearchapi.dev/v1/jobs?limit=20&state=completed" \
  -H "Authorization: Bearer $AISEARCH_API_KEY"

const res = await fetch(
  'https://api.aisearchapi.dev/v1/jobs?limit=20&state=completed',
  { headers: { Authorization: `Bearer ${process.env.AISEARCH_API_KEY}` } },
);
const page = await res.json();

import os, requests

res = requests.get(
    "https://api.aisearchapi.dev/v1/jobs",
    params={"limit": 20, "state": "completed"},
    headers={"Authorization": f"Bearer {os.environ['AISEARCH_API_KEY']}"},
)
page = res.json()

Response

200 OK

{
  "items": [
    {
      "id": "job_8t2q",
      "status": "completed",
      "prompt": "best crm for startups",
      "createdAt": "2026-06-30T17:02:11Z"
    },
    {
      "id": "job_5k9d",
      "status": "partial",
      "prompt": "cheapest ev in europe 2026",
      "createdAt": "2026-06-30T16:41:02Z"
    }
  ],
  "nextCursor": "eyJvZmZzZXQiOjIwfQ"
}

items

object[]

One entry per parent job, newest first.

Show item

string

The parent job id (dotless). Read it with GET /v1/jobs/:id for its rollup and children.

status

string

The parent rollup state.

prompt

string

The submitted query.

createdAt

string

ISO-8601 submission timestamp.

nextCursor

string | null

Pass as ?cursor= to fetch the next page. null on the last page.

Paginate to the end

async function* allJobs() {
  let cursor;
  do {
    const url = new URL('https://api.aisearchapi.dev/v1/jobs');
    url.searchParams.set('limit', '100');
    if (cursor) url.searchParams.set('cursor', cursor);
    const res = await fetch(url, {
      headers: { Authorization: `Bearer ${process.env.AISEARCH_API_KEY}` },
    });
    const page = await res.json();
    yield* page.items;
    cursor = page.nextCursor;
  } while (cursor);
}

for await (const job of allJobs()) console.log(job.id, job.status);

import os, requests

def all_jobs():
    cursor = None
    while True:
        params = {"limit": 100}
        if cursor:
            params["cursor"] = cursor
        res = requests.get(
            "https://api.aisearchapi.dev/v1/jobs",
            params=params,
            headers={"Authorization": f"Bearer {os.environ['AISEARCH_API_KEY']}"},
        )
        page = res.json()
        yield from page["items"]
        cursor = page["nextCursor"]
        if not cursor:
            break

for job in all_jobs():
    print(job["id"], job["status"])

Get a job

Read a parent rollup or a single child Envelope.

Cancel a job

Stop a parent’s remaining children.

Endpoints

Account & discovery

Watches

By surface

Query parameters

Request

Response

Paginate to the end

Get a job

Cancel a job

​Query parameters

​Request

​Response

​Paginate to the end

Get a job

Cancel a job

Query parameters

Request

Response

Paginate to the end