Skip to main content
GET
List a project's prompt run history

Authorizations

Authorization
string
header
required

Clerk API key. Create one from your account settings under API Keys.

Query Parameters

projectId
string<uuid>
required

Project id. Required on all data endpoints.

status
enum<string>[]

Repeat this parameter or provide comma-separated values to filter by run status.

Available options:
pending,
running,
completed,
failed,
interrupted
startedAfter
string<date-time>
startedBefore
string<date-time>
completedAfter
string<date-time>
completedBefore
string<date-time>
triggeredBy
enum<string>
Available options:
manual,
scheduled
platform
enum<string>[]

Repeat this parameter or provide comma-separated values to filter by platform ID.

LLM platform identifier. Newer scraper-backed ids end in _app; chatgpt, perplexity, and gemini are legacy and not returned by current runs.

Available options:
chatgpt,
chatgpt_app,
claude,
gemini,
gemini_app,
grok_app,
grok_api,
perplexity,
perplexity_app,
google_app,
deepseek
sortBy
enum<string>
default:ordinal
Available options:
ordinal,
status,
startedAt,
completedAt,
duration
sortDir
enum<string>
default:desc
Available options:
asc,
desc
limit
integer
default:25
Required range: 1 <= x <= 100
offset
integer
default:0
Required range: x >= 0

Response

Successful response

runs
object[]
required
total
integer
required
limit
integer
required
offset
integer
required