Skip to main content
GET
List a job's executions

Headers

x-project-id
string
required

Project ID to specify the project context

Path Parameters

jobId
string
required
projectId
string<uuid>
required

Query Parameters

page
integer
default:1

Which slice of the matched rows to return, counted from 1. Rows skipped are (page - 1) * limit.

Required range: 1 <= x <= 1000000
Example:

2

limit
integer
default:25

How many rows one page holds, capped at 100 to keep a single response bounded.

Required range: 1 <= x <= 100
Example:

50

status
enum<string>[]

Any of these; repeat the key or separate with commas

Available options:
pending,
success,
failed,
retrying
models
string[]

Raw model names; repeat the key or separate with commas

Example:
queryIds
string<uuid>[]

Executions of any of these queries, at most 100 ids; repeat the key or separate with commas

Maximum array length: 100
Example:
createdAfter
string<date-time>

Only executions created at or after this time; a job's executions share its launch time

Example:

"2026-11-01T00:00:00.000Z"

createdBefore
string<date-time>

Only executions created at or before this time

Example:

"2026-11-30T23:59:59.999Z"

sort
string

Comma-separated field:asc|desc on createdAt, updatedAt, status or model. The default order is stable for paging; a sort on status or updatedAt is not

Example:

"model:asc"

include
enum<string>[]

Adds each execution's answer with these blocks; repeat the key or separate with commas. A page then holds at most 50 rows, and 25 when it holds text

Available options:
text,
entities,
citations,
listings,
ads,
fan_outs,
theme_mentions
Example:

Response

page
object
required
results
object[]