GET /api/v1/jobs

List your jobs

Auth: required. Send an ivy_ API key (Authorization: Bearer ivy_… or X-Ivy-Api-Key), a Clerk session JWT (Authorization: Bearer …) or the Clerk __session cookie (browser sessions). See Authentication.

Page through the jobs you own or can reach through your projects, newest first. Filters combine; page / pageSize paginate by offset, and next_cursor in the response gives the cursor for the next page.

Request

Query parameters

pageinteger

1-based page number.

pageSizeinteger

Jobs per page (capped at 1000).

statusstring

Comma-separated job statuses to include.

typestring

Job type (tool) to include.

projectIdstring

Only jobs in this project.

qstring

Job id (exact) or text matched against the job title.

startstring (date-time)

Only jobs submitted at or after this time.

endstring (date-time)

Only jobs submitted at or before this time.

onlyActiveboolean

Only jobs that have not reached a terminal status.

cursorSubmittedAtstring

Cursor from next_cursor.cursorSubmittedAt.

cursorIdstring

Cursor from next_cursor.cursorId.

Responses

`200` OK

A page of jobs

Response shape:

jobsobject[]

Job records, newest first.

total_countinteger

Total matching jobs, when known.

pageinteger

1-based page number.

page_sizeinteger

Jobs per page after the cap.

total_pagesinteger

has_moreboolean

next_cursorobject

`401` Unauthorized

Missing or invalid credentials

`429` Too Many Requests

Rate limited

curl -X GET 'https://ivybiosciences.com/api/v1/jobs' \
  -H "Authorization: Bearer $IVY_API_KEY"

Was this page helpful?