Skip to main content
GET
/
jobs
cURL
# Get all jobs:
curl "https://api.ionq.co/v0.4/jobs" \
  -H "Authorization: apiKey your-api-key"
{
  "jobs": [
    {
      "id": "<string>",
      "status": "submitted",
      "type": "<string>",
      "backend": "<string>",
      "dry_run": true,
      "submitter_id": "<string>",
      "project_id": "<string>",
      "parent_job_id": "<string>",
      "session_id": "<string>",
      "metadata": {},
      "name": "<string>",
      "submitted_at": "<string>",
      "started_at": "<string>",
      "completed_at": "<string>",
      "predicted_wait_time_ms": 123,
      "predicted_execution_duration_ms": 123,
      "execution_duration_ms": 123,
      "shots": 123,
      "failure": {
        "code": "InvalidInput",
        "message": "<string>"
      },
      "output": {},
      "settings": {},
      "stats": {},
      "results": {},
      "noise": {
        "model": "ideal",
        "seed": 123
      }
    }
  ],
  "next": "<string>"
}
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
session_id
string
limit
integer<int32>
next
string

Response

Successfully retrieved a list of jobs.

jobs
object[]
required
next
string | null
required