v1

latestOpenAPI 3.1.02026-07-26102230.9 KB
jobs

Get All Jobs

Retrieve a paginated list of quantum jobs for the authenticated user.

Query Parameters:

  • vendor (string, optional): Filter by vendor (e.g., aws, ibm, qbraid, or all)
  • provider (string, optional): Filter by provider name
  • statusGroup (string, optional): Filter by status group — pending, returned, or all
  • status (string, optional): Filter by individual job status (takes priority over statusGroup)
  • search (string, optional): Search jobs by keyword (1–255 characters)
  • tags (string, optional): Filter by tags as a JSON object (e.g., {"env":"prod"})
  • page (integer, optional): Page number (default: 1)
  • limit (integer, optional): Items per page, max 100 (default: 50)

Returns:

  • Paginated array of RuntimeJob objects with pagination metadata

Raises:

  • 401: Authentication required
  • 422: Validation error if query parameters are invalid
get/jobs

Query parameters

vendor'aws' | 'azure' | 'ibm' | 'ionq' | 'qbraid' | 'all'

Filter jobs by vendor

Filter jobs by vendor

providerstring

Filter jobs by provider name

Filter jobs by provider name

statusGroup'all' | 'pending' | 'returned'

Filter by status group

Filter by status group — pending (active/in-progress), returned (completed/failed/cancelled), or all

status'INITIALIZING' | 'QUEUED' | 'VALIDATING' | 'RUNNING' | 'CANCELLING' | 'CANCELLED' | 'COMPLETED' | 'FAILED' | 'UNKNOWN' | 'HOLD'

Filter by individual job status

Filter by individual job status. Takes priority over statusGroup when both are provided

searchstring

Search keyword

Search jobs by keyword (1–255 characters)

tagsstring

JSON object of tag key-value pairs to filter by

Example:{"experiment":"bell-state"}

Filter by tags as a JSON object (e.g., {"experiment":"bell-state"})

pageinteger

Page number (1-indexed)

Page number (1-indexed, default: 1)

limitinteger

Number of items per page

Number of items per page (1–100, default: 50)

Response

Successful Response

successboolean required