GET
/
jobs
/
{UUID}
curl "https://api.ionq.co/v0.4/jobs/617a1f8b-59d4-435d-aa33-695433d7155e" \
  -H "Authorization: apiKey your-api-key"
{
  "id": "e1a09d90-b2ba-4ea5-9fd7-4bfc14eac524",
  "status": "completed",
  "type": "ionq.circuit.v1",
  "backend": "simulator",
  "dry_run": false,
  "submitter_id": "64b03577072d45001c85e9c4",
  "project_id": "1333d459-cf47-4a5e-acc1-8d4eb4f7b025",
  "parent_job_id": null,
  "child_job_ids": null,
  "session_id": null,
  "metadata": null,
  "name": null,
  "submitted_at": "2025-05-28T20:47:05.440Z",
  "started_at": null,
  "completed_at": null,
  "predicted_execution_duration_ms": null,
  "predicted_wait_time_ms": null,
  "execution_duration_ms": null,
  "shots": 1000,
  "noise": {
    "model": "ideal"
  },
  "failure": null,
  "settings": {
    "compilation": {}
  },
  "stats": {
    "qubits": 20,
    "circuits": 1,
    "gate_counts": {
      "1q": 1028,
      "2q": 110
    }
  },
  "results": {
    "probabilities": {
      "url": "/v0.4/jobs/e1a09d90-b2ba-4ea5-9fd7-4bfc14eac524/results/probabilities"
    }
  },
  "output": {}
}

Retrieve detailed information about a specific job using its unique identifier. This returns the job’s current status, execution details, results (if completed), and metadata including timing information, gate counts, and failure details if applicable.

Learn more about viewing job results.

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

Path Parameters

​
UUID
string
required

The UUID of the job — this UUID is provided in the response on job creation.

Response

200 - application/json

Successfully retrieved a job.

The response is of type object.

GET
/
jobs
/
{UUID}
curl "https://api.ionq.co/v0.4/jobs/617a1f8b-59d4-435d-aa33-695433d7155e" \
  -H "Authorization: apiKey your-api-key"
{
  "id": "e1a09d90-b2ba-4ea5-9fd7-4bfc14eac524",
  "status": "completed",
  "type": "ionq.circuit.v1",
  "backend": "simulator",
  "dry_run": false,
  "submitter_id": "64b03577072d45001c85e9c4",
  "project_id": "1333d459-cf47-4a5e-acc1-8d4eb4f7b025",
  "parent_job_id": null,
  "child_job_ids": null,
  "session_id": null,
  "metadata": null,
  "name": null,
  "submitted_at": "2025-05-28T20:47:05.440Z",
  "started_at": null,
  "completed_at": null,
  "predicted_execution_duration_ms": null,
  "predicted_wait_time_ms": null,
  "execution_duration_ms": null,
  "shots": 1000,
  "noise": {
    "model": "ideal"
  },
  "failure": null,
  "settings": {
    "compilation": {}
  },
  "stats": {
    "qubits": 20,
    "circuits": 1,
    "gate_counts": {
      "1q": 1028,
      "2q": 110
    }
  },
  "results": {
    "probabilities": {
      "url": "/v0.4/jobs/e1a09d90-b2ba-4ea5-9fd7-4bfc14eac524/results/probabilities"
    }
  },
  "output": {}
}

Retrieve detailed information about a specific job using its unique identifier. This returns the job’s current status, execution details, results (if completed), and metadata including timing information, gate counts, and failure details if applicable.

Learn more about viewing job results.

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

Path Parameters

​
UUID
string
required

The UUID of the job — this UUID is provided in the response on job creation.

Response

200 - application/json

Successfully retrieved a job.

The response is of type object.