List all jobs with filtering and pagination

Required scope: read

GET /api/v1/jobs

cURL

curl --request GET \
  --url 'https://api.nsr.stateset.com/api/v1/jobs' \
  --header "X-API-Key: $STATESET_NSR_API_KEY"

200

{
  "count": 2,
  "jobs": [
    {
      "completed_at": 1,
      "created_at": 1,
      "error": "string",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "input": null,
      "job_type": "batch_infer",
      "progress": 1,
      "result": null,
      "status": "pending",
      "updated_at": 1
    }
  ],
  "limit": 20,
  "offset": 1,
  "total": 102
}

Required scope: read

Query parameters

status · object

Filter by status

job_type · object

Filter by job type

limit · integer

Maximum results (default: 100)

offset · integer

Pagination offset (default: 0)

sort_by · string

Sort field (created_at, updated_at)

sort_order · string

Sort order (asc, desc)

created_after · integer (int64)

Only jobs created after this timestamp

created_before · integer (int64)

Only jobs created before this timestamp

Response

ListJobsResponse

count · integer · required

Number of jobs returned

jobs · Job[] · required

List of jobs

Show Job

completed_at · integer (int64)

Completion timestamp (Unix ms, if completed)

created_at · integer (int64) · required

Creation timestamp (Unix ms)

error · string

Error message if failed

id · string · required

Unique job identifier

input · object · required

Input parameters

job_type · JobType · required

progress · integer (int32) · required

Progress percentage (0-100)

result · object

Result data (JSON)

status · JobStatus · required

updated_at · integer (int64) · required

Last update timestamp (Unix ms)

limit · integer · required

Limit used

offset · integer · required

Offset used

total · integer · required

Total count (before pagination)

Status codes

Code	Meaning
200	List of jobs
401	Unauthorized — missing or invalid credentials
403	Forbidden — the key/token lacks the required scope
429	Rate limited — see Retry-After / X-RateLimit-Reset

cURL

curl --request GET \
  --url 'https://api.nsr.stateset.com/api/v1/jobs' \
  --header "X-API-Key: $STATESET_NSR_API_KEY"

200

{
  "count": 2,
  "jobs": [
    {
      "completed_at": 1,
      "created_at": 1,
      "error": "string",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "input": null,
      "job_type": "batch_infer",
      "progress": 1,
      "result": null,
      "status": "pending",
      "updated_at": 1
    }
  ],
  "limit": 20,
  "offset": 1,
  "total": 102
}