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': 'Error Name',
    'message': 'A description of the specific error conditions.',
    'statusCode': 400
}

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

IonQ v0.3 API

Jobs

Characterizations

Backends

Reports

Job Errors

​Job Errors

Job Errors