POST
/
jobs
curl -X POST "https://api.ionq.co/v0.4/jobs" \
  -H "Authorization: apiKey your-api-key" \
  -H "Content-Type: application/json" \
  -d '{ 
    "type" : "ionq.circuit.v1", 
    "name": "Sample circuit", 
    "metadata": {
      "fizz": "buzz",
      "foo": "bar"
    },
    "shots": 500,
    "backend": "qpu.forte-1",
    "settings" :
    {
      "error_mitigation": 
      { 
        "debiasing": false
      }
    },
    "input": {
      "qubits":  2,
      "gateset": "qis", 
      "circuit": [
      {
        "gate": "h",
        "target": 0
      }
      ]
    }
  }'
{
  "id": "617a1f8b-59d4-435d-aa33-695433d7155e",
  "status": "submitted",
  "session_id": null
}

Submit a quantum circuit to run on a backend by creating a new job. You can specify the number of shots, target backend (QPU or simulator), and optional settings like error mitigation. The job will be queued and executed according to the platform’s scheduling system.

Learn more about submitting circuits via API.

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

Body

application/json

Response

201 - application/json

Created

The response is of type object.