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

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.