Skip to main content
GET
cURL
List all jobs in your project with optional filtering by job status (submitted, ready, started, canceled, failed, completed). This provides a paginated overview of your job history including basic metadata and timing information for each job.

Authorizations

Authorization
string
header
required

API keys are associated with a user and can be created on the IonQ Quantum Cloud application. To authenticate, prefix your API Key with apiKey and place it in the Authorization request header. Ex: Authorization: apiKey your-api-key

Query Parameters

ids
string[]
parent_job_id
string
status
enum<string>
Available options:
submitted,
ready,
started,
canceled,
failed,
completed
target
string

Filter jobs by backend target. Supports single target or comma-separated list of targets.

session_id
string
submitter_id
string

The id of another user within a shared project to view their submitted jobs. Ignored if not a project member.

limit
integer<int32>
next
string

Response

Successfully retrieved a list of jobs.

jobs
object[]
required

List of jobs. Common fields are shown below; each entry's full per-type shape (with settings, stats, output, results documented by job type) is available on the Get Job page.

next
string | null
required