Skip to main content
GET
/
jobs
/
estimate
cURL
curl --request GET \
  --url https://api.ionq.co/v0.4/jobs/estimate \
  --header 'Authorization: <api-key>'
{
  "input_values": {
    "backend": "simulator",
    "type": "ionq.circuit.v1",
    "qubits": 25,
    "shots": 1000,
    "1q_gates": 0,
    "2q_gates": 0,
    "error_mitigation": false
  },
  "estimated_at": "<string>",
  "cost_unit": "<string>",
  "rate_information": {
    "job_cost_minimum": 123,
    "cost_2q_gate": 123,
    "cost_1q_gate": 123,
    "organization": "<string>"
  },
  "estimated_cost": 123,
  "estimated_execution_time": 123,
  "current_predicted_queue_time": 123
}

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

​
backend
enum<string>
required
Available options:
simulator,
qpu.aria-1,
qpu.aria-2,
qpu.forte-1,
qpu.forte-enterprise-1
​
type
string
default:ionq.circuit.v1
​
qubits
integer<int32>
default:25
​
shots
integer<int32>
default:1000
​
1q_gates
integer<int32>
default:0
​
2q_gates
integer<int32>
default:0
​
error_mitigation
boolean
default:false

Response

Successfully retrieved the cost estimate of a job.

​
input_values
object
required
​
estimated_at
string
required
​
cost_unit
string
required
​
rate_information
object
required
​
estimated_cost
number<double>
required
​
estimated_execution_time
number<double>
required
​
current_predicted_queue_time
number<double>
required