API error codes

1XXX

Error code

Message

Solution

1000

API Internal error.

Try the action again. If it happens again, contact IBM Quantum via Slack for help.

1001

qObject is larger than the maximum size.

Run a small Job. Split the circuits in smaller jobs.

1002

Error in the validation process of the job.

Check the Job, it is not valid to run on this backend.

1003

Error in transpilation process.

Check the Job, it is not valid to run on this backend.

1004

The Backend is not available.

Use another backend to run the job.

1005

Basis gates not available.

Use another backend with basis gates.

1006

Error during call to converter microservice.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

1007

Backend not found.

Check the backend name, maybe it is wrong.

1008

Error during the validation process of a job.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

1009

Required backend information not found.

Use another backend to run the job.

1010

Error returned at backend level.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

1011

Error publishing job at the backend queue.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

1012

The user reached the maximum number of jobs running concurrently.

Wait until some previous jobs were finished. You can cancel pending jobs to run new jobs.

1101

Qobj does not conform to the schema.

Verify the Qobj for your job conforms to the Qobj schema.

1102

The number of experiments in the Qobj is higher than the number of experiments supported by the backend.

Split the experiments into multiple jobs. The maximum number of experiments the backend supports can be found in its configuration data.

1103

The number of shots in the Qobj is higher than the number of shots supported by the backend.

Use fewer shots. The maximum number of shots the backend supports can be found in its configuration data.

1104

The Qobj requests memory measurement, but the backend does not support memory.

Run the job on a backend that supports memory or don’t request memory measurement. Whether a backend supports memory measurement can be found in its configuration data.

1105

The number of qubits used in the Qobj is higher than the number of quantum registers defined in the Qobj.

Correct your program and try again.

1106

The Qobj uses gates that are not among the backend’s basis gates.

Correct your program and try again. Transpiling your program will convert high level gates to basis gates. The basis gates for a backend can be found in its configuration data.

1107

The Qobj includes an instruction that assumes a coupling map that is different from the backend’s coupling map.

Correct your program and try again. Transpiling your program will map instructions to the correct qubits based on the backend’s coupling map. The coupling map for a backend can be found in its configuration data.

1108

The backend does not support open pulse.

Run the job on a backend that supports open pulse. Whether a backend supports open pulse can be found in its configuration data.

1109

The number of qubits used in the Qobj is more than the number of qubits supported by the backend.

Run the job on a backend that supports sufficient number of qubits for the job. The number of qubits a backend supports can be found in its configuration data.

1999

Planned outage. The service is undergoing maintenance.

Please wait. The service will be back up soon. The website portal will have more information about what the expected time window for the maintenance work is.

2XXX

Error code

Message

Solution

2000

Backend not found.

Check the backend name, maybe it is wrong.

2001

Backend not available for booking.

Use another backend to book a time slot.

2002

Backend not available for this action.

Use another backend.

2100

Invalid URL to Upload to Bluemix.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

2200

A booking already exists.

Select another date to book.

2201

Booking data is not valid.

Check the booking data, maybe it is wrong.

2202

Cannot cancel booking.

Check the booking to cancel.

2203

Provider does not have enough remaining time to book.

Use another provider to book or contact your Group Administrator.

2204

User already has a booking on that date.

Select another date to book.

2205

Booking not found.

Check the booking data, maybe it is wrong.

2206

Booking on calibration time.

Select another date to book.

2300

Code ID not found.

Check the code data, maybe it is wrong.

2301

Code not updated.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

2302

Code wrong.

Check the code data, maybe it is wrong.

2304

Error parsing QASM.

Check the code data, maybe it is wrong.

2305

Invalid Code.

Check the code data, maybe it is wrong.

2306

Invalid result.

Check the code data, maybe it is wrong.

2307

QASM transpilation error.

Check the code data, maybe it is wrong.

2308

User role not found.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

2309

Code not found.

Check the code data, maybe it is wrong.

2310

Failed to export.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

2311

Image wrong.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

2313

QASM not found.

Check the code data, maybe it is wrong.

2400

Error wrong data received.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

2402

Maximum attempts reached.

Reduce the number of concurrent requests.

2403

Missing data in HTTP request.

Check your request to the endpoint.

2404

Model not found in database.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

2405

Error saving new data.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

2407

Authentication required.

Try to login again.

2408

Invalid Access Token.

Try to login again.

2409

Forbidden.

You don’t have access to do the action.

2410

Service not accessible.

You don’t have access to do the action.

2411

Operation not available.

You don’t have access to do the action.

2412

Error retrieving data from database.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

2600

Configuration not available for this system.

Try to use another backend.

2602

System not allowed.

Try to use another backend.

2603

Error getting topology attributes.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

2604

Error getting topology queues.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

2609

Properties are empty.

Try to use another backend.

2614

Topology without kind established.

Try to use another backend. Contact an IBM Quantum administrator.

2615

The system is not available.

Try to use another backend.

2616

This system can only be used for running jobs.

Try the Jobs API. Try to use another backend.

2618

Basis gates not available.

Try to use another backend.

2620

System not found.

Try to use another backend.

2622

Properties not found.

Try to use another backend.

2900

An error occur getting the hub.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

2901

Error checking hub or group administrators.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

2902

Error checking systems in the Hub.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

2903

Hub info not found.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

2904

Invalid backend to configure for booking.

Use another backend.

2905

Invalid parameters to configure for booking.

Check the booking configuration.

2906

Invalid priority value.

Change the priority Value.

2907

System not available for Hub.

Use another backend.

2908

Error checking user in the Hub.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

2909

Group not found.

Use another Group.

2910

Hub not found.

Use another Hub.

2911

Invalid Hub/Group/Project.

Use another provider.

2912

Invalid mode to configure for booking.

Use another mode to book a backend.

2913

Project not found.

Use another project.

2914

This hub is not allowed to view analytics.

Use another hub.

3XXX

Error code

Message

Solution

3200

Backend not valid.

Use another backend.

3202

Cannot get presigned download url.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3203

Cannot get presigned upload url.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3204

Error during call to converter microservice.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3207

Job access not allowed.

Access another Job.

3208

Job not cancelled.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3209

Job not running.

Check if the action makes sense.

3210

Job not saved.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3211

Job not valid.

Check the Job sent, maybe it is wrong.

3212

Job not validated.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3213

Job status not valid.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3214

Job transition not valid.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3215

Job without code identificator.

Check the Job sent, maybe it is wrong.

3216

Limit not valid.

Change the limit sent into the request.

3218

Number of Shots not allowed.

Change the number of shots.

3220

Payload not valid.

Change the body sent into the request. Maybe its format is wrong.

3224

Q-Object memory not allowed.

Disable the memory parameter in the Job.

3226

Q-Object not valid.

Check the format of the Job. Maybe it is wrong.

3228

Q-Object-External-Storage property not allowed in this backend.

Send the content of the Job inside of the body.

3229

QASM no longer accepted.

Use Q-Object format.

3230

Seed not allowed.

Don’t send seed parameter.

3233

The job can’t be created.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3234

The job can’t be validated.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3235

Job cost cannot be calculated.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3236

The job is empty.

Check the job sent. Maybe it is empty.

3237

The job is invalid.

Check the job sent. Maybe it is wrong.

3239

Number of registers exceed the number of qubits.

Define the same creg as qreg.

3242

Circuit count exceeded.

Send smaller number of circuits in the Job.

3243

Circuit is too big.

Reduce the content of the circuit.

3245

The queue is disabled.

Use another backend.

3246

The queue is unavailable.

Use another backend.

3248

Your job is too long.

Reduce the content of the job.

3249

Job fields are empty.

Check the Job content. Maybe it is empty.

3250

Job not found.

Check the job Id to query. It is wrong.

3251

Job not uploaded to object storage.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3252

Object storage not allowed.

Send the job into the body of the request.

3253

Timeout getting the result.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3254

The job is not in queue.

Check the status of the job.

3255

Invalid share level.

Update the share level.

3259

Cannot recover job that failed while executing.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3265

Input type not allowed by backend.

Use another backend.

3300

Cannot download job data.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3301

Cannot upload job data.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3302

Job not found.

Check the job information. Maybe it is wrong

3400

License not found.

Accept the license.

3402

API key not found.

Regenerate the API Token.

3405

Codes not deleted.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3407

User API token not valid.

Check the API Token.

3409

Error deleting entities from user.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3410

Error deleting user relations.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3418

Failed to create the token for the user.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3422

Old password is incorrect.

Check your old password. It is wrong.

3423

Passwords do not match.

Check the password. It is wrong.

3424

Retrieving last version licenses, including future ones.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3425

Retrieving last version licenses.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3440

Authentication is required to perform that action.

Try to login again.

3443

Failed to check login.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3444

License required. You need to accept the License.

Accept the license.

3445

Login with IBM ID required.

Login using IBM ID.

3446

Login failed.

Try to login again.

3452

The license is not accepted.

Accept the License.

3453

The license is required.

Accept the License.

3458

User reached the maximum limits of concurrent jobs.

Wait until some previous jobs were finished. You can cancel pending jobs to run new jobs.

3459

User is blocked by wrong password.

Wait 5 minutes to login again.

3460

User is blocked.

Contact an IBM Quantum Administrator.

3467

Failed to create or renew API token.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3468

Failed to get API token.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3500

Body is wrong.

Check the body of the request.

3704

Error to get status from Queue.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3811

Request not found.

Check the request that you are trying to do.

3900

Empty response from the stats micro-service.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3901

Error parsing stats.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3902

Error retrieving stats.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3903

Invalid date.

Update the dates

3904

Invalid end date.

Update the end date.

3905

Invalid input to the stats micro-service.

Check the query. It is wrong.

3906

Invalid key.

Check the query. It is wrong.

3907

Invalid start date.

Update the start date.

3908

Invalid stats type.

Check the query. It is wrong.

3909

Missing mandatory user stats info.

Check the query. It is wrong.

3910

Number of months too big.

Reduce the number of months.

3911

Stats micro-service is not available.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3912

Stats not found.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3913

Analytics stats not found.

Retry the action. If it happens again, contact IBM Quantum via Slack for help.

3914

Project level does not support aggregated analytics stats.

Try to use another project.

3915

Missing start/end dates; allTime not set to true for analytics stats

Set start and end date in the query.

5XXX

Error code

Message

Solution

5201

Job timed out after {} seconds.

Reduce the complexity of the job, or number of shots.

5202

Job was canceled.

None. Job was canceled.

6XXX

Error code

Message

Solution

6000

Too many shots given ({} > {}).

Reduce the requested number of shots.

6001

Too few shots given ({} < {}).

Increase the number of shots.

6002

Too many experiments given ({} > {}).

Reduce the number of experiments given at once.

6003

Too few experiments given ({} < {}).

Increase number of experiments.

7XXX

Error code

Message

Solution

7000

Instruction not in basis gates: instruction: {}, qubits: {}, params: {}

Instruction not supported by backend. Please remove the instruction shown in the error message.

7001

Instruction {} is not supported.

Remove unsupported instruction, or run on a simulator that supports it.

7002

Memory output is disabled.

Select a different backend or set memory=False in transpile / execute.

7003

qubits: {} and classical bits: {} do not have equal lengths.

Length of memory slots must be same as number of qubits used.

7004

Qubit measured multiple times in circuit.

Remove multiple measurements on qubits.

7005

Error in supplied instruction.

Please refer to the Operations glossary and make sure the instructions are correct.

7006

Qubit measurement is followed by instructions.

Cannot perform any instruction on a measured qubit. Please remove all instructions following a measurement.

8XXX

Error code

Message

Solution

8000

Channel {}{} lo setting: {} is not within acceptable range of {}.

Set channel LO within specified range.

8001

Qubits {} in measurement are not mapped.

Assign qubits to a classical memory slot.

8002

Total samples exceeds the maximum number of samples for channel {}. ({} > {}).

Reduce number of samples below specified limit.

8003

Total pulses exceeds the maximum number of pulses for channel: {}, ({} > {}).

Reduce number of pulses below specified limit.

8004

Channel {}{} is not available.

Must use available drive channels.

8006

Gate {} in line {}s not understood ({}).

This instruction is not supported. Please make sure that the gate name is correct and it is found within the Operations glossary.

8007

Qasm gate not understood: {}.

This instruction is not understood. Please make sure it is found within the Operations glossary.

8008

Unconnected Qubits.

Check the topology diagram for this system (go to the Services page and click on the system) and make sure the qubits are connected.

8009

Measurement level is not supported.

The given measurement level is not supported on this backend. Please change it to 0-2 except the measurement level specified.

8011

Pulse experiments are not supported on this system.

Pulse experiment is not supported on this backend. Please use a backend that supports pulse to run this experiment.

8013

This backend does not support conditional pulses.

Conditionals are not supported on this backend. Please remove the conditional instruction in your program.

8014

Reset instructions are not supported.

Reset instructions are not supported at this time for this backend. Please remove the reset instruction.

8016

Pulse {} has too few samples ({} > {}).

Please add more samples.

8017

Pulse not a multiple of {} samples.

Due to hardware limitations, pulses must be a multiple of a given number of samples.

8018

Waveform memory exceeds the maximum amount of memory currently available.

Reduce the number of samples in the waveform.

8019

For channel {}{}, Final channel time exceeds max time ({} > {}).

Reduce the total length of pulse sequence on the specified channel.

8020

Circuit runtime is greater than the device repetition rate.

Circuit too long, reduce length of circuit.

8021

Acquires have durations of different length.

Set acquire operations to have the same length.

8022

Pulse {} has too many samples ({} > {}).

Reduce number of samples in the specified pulse.

8023

{0} {1} is an invalid entry. {0} should be a positive integer.

Make entry positive integer.

8024

At most one acquire currently supported per acquisition channel.

Use only one acquire command per channel.

8026

Supplied qubits ({0}) in acquire are not valid.

Fix the qubits specified in the acquire commands.

8027

Channel specified: {} is not available.

Channel does not exist on system.

8029

Repetition time ({0}) not supported.

Repetition time must be changed to a supported value.

8030

Repetition delay ({0}) not supported.

The delay is not supported.

8031

Submitted job is too long.

Reduce the length of the job.

8033

Qobj type not provided in config.

Add type to qobj['config'].

8035

Instruction {0} at timestep {1}dt overlaps with instruction {2} at timestep {3}dt on channel {4}.

Two instructions cannot be played at the same time on a channel.

8036

All measure(circuit) and acquire(pulse) instructions must align to a 16 sample boundary. Measurements may be impacted by delays which have non-multiple of 16 durations.

Due to hardware limitations, measure and acquire instructions must occur at 16 sample multiples.

8037

ESP readout not enabled on this device.

Set use_measure_esp=False or remove from run options.

9XXX

Error code

Message

Solution

9999

Internal error.

Contact IBM Quantum via Slack for help.