IonQ APIs
v0.3 Error Codes
When a request fails, the API will respond with an appropriate 400 or 500 error in the following format in the body of the response:
Error | Description |
---|---|
Bad Request | Generic request error. The message should indicate the specific parameter which was invalid. |
Forbidden | The request failed to authenticate the supplied API key |
Unauthorized | The supplied API key failed authorization for the requested resource |
Not Found | The specified resource does not exist or could not be found. |
Internal Server Error | A service was unexpectedly offline, unavailable, or failed in an unknown manner. |
Job Errors
The following errors are specific to the /job
(API reference) resource:
Error | Description |
---|---|
BillingError | Generic error inside of the billing service |
CompilationError | Generic failure in our compilation service |
ContractExpiredError | The billing service shows that the contract governing the key being used has expired |
DebiasingError | Unknown execution error when using debiasing (an IonQ-provided error mitigation technique) |
InternalError | An unattributable internal error |
NotEnoughQubits | The backend you are submitting to has fewer qubits than this job requires |
OptimizationError | Generic error in our optimization service |
PreflightError | Generic error during preflight checks. This most often occurs when the input circuit is syntax checked and includes malformed gates, commands, formats, or similar |
QuantumCircuitComplexityError | This failure occurs when the coherent program used to execute this circuit cannot be feasibly run on the system targeted. Reducing the number of gates requested can often resolve this issue. |
QuantumComputerError | Generic failure that occured while the job was being processed on-QPU |
QuotaExhaustedError | The billing system shows that your user, project, or organization has an inadequate credit balance to run this job |
SimulationError | Generic failure in our simulation service |
SimulationTimeout | Timeout error in our compilation service. This is most commonly caused by simulations that are too large for the service to simulate before hitting our runaway process timeout |
SystemCancel | A member of IonQ staff has manually cancelled your job. This most often occurs as a result of a customer request, but can sometimes represent manual resolution of an unknown failure mode |
TooLongPredictedExecutionTime | preflight error of a specific type: the predicted execution time for the circuit was longer than the single-job timeout duration for a given backend |
TooManyControls | The job submitted includes a multi-control gate with more control qubits (7 or more) than the target backend allows |
TooManyGates | Preflight error of a specific type: the job submitted includes more gates per circuit than the target backend allows |
TooManyShots | Preflight error of a specific type: the job submitted requested more shots than the target backend allows |
UnknownBillingError | Unknown error related to but not originating from our billing service. This most often means the service is briefly unavailable for some reason. |
UnsupportedGate | Preflight error of a specific type: the job submitted uses a gate that the target backend does not allow |
Was this page helpful?