Docs

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	The Qobj requests memory measurement, but the backend does not support memory.	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 log in again.
2408	Invalid Access Token.	Try to log in again.
2409	Forbidden.	You don’t have authority to perform the action.
2410	Service not accessible.	You don’t have authority to perform the action.
2411	Operation not available.	You don’t have authority to perform 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.	Retry the action. If it happens again, contact IBM Quantum via Slack for help.
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 satus 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	This system can only be used for running jobs.	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 log in 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, then log in 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 getting status from the 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 perform.
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 incorrect.
3906	Invalid key.	Check the query. It is incorrect.
3907	Invalid start date.	Update the start date.
3908	Invalid stats type.	Check the query. It is incorrect.
3909	Missing mandatory user stats info.	Check the query. It is incorrect.
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.
5203	Failed to run job.	Try to run the job again.
5204	Error raised when execution on AER failed.	Try to run the job again.

6XXX ¶

Error code	Message	Solution
6000	Too many shots given ({} > {}).	Reduce the requested number of shots.
6001	Too few shots given ({} < {}).	Increase the requested number of shots.
6002	Too many experiments given ({} > {}).	Reduce the number of experiments.
6003	Too few experiments given ({} < {}).	Increase the number of experiments.

7XXX ¶

Error code	Message	Solution
7000	Instruction not in basis gates:<br>instruction: {}, qubits: {}, params: {}	Instruction not supported by backend. 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.	Refer to the Operations glossary and verify that the instructions are correct.
7006	Qubit measurement is followed by instructions.	Cannot perform any instruction on a measured qubit. 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. Make sure that the gate name is correct and is found within the Operations glossary.
8007	Qasm gate not understood: {}.	This instruction is not understood. Make sure it is found within the Operations glossary.
8008	Unconnected Qubits.	Check the topology diagram for this system (go to the Compute resources page and click 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. 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. 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. Remove the conditional instruction in your program.
8014	Reset instructions are not supported.	Reset instructions are not supported at this time for this backend. Remove the reset instruction.
8016	Pulse {} has too few samples ({} > {}).	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 the number of samples in the specified pulse.
8023	{0} {1} is an invalid entry. {0} should be a positive integer.	Make the entry a 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}) is not supported.	Repetition time must be changed to a supported value.
8030	Repetition delay ({0}) is 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.
8039	A combination of pulses on the logical channels is exceeding the hardware output due to internal usage of hardware output. This will typically be a result of drive and control channels being mapped to the same physical channel in the hardware and the summed total of the applied pulses (including additional internal pulses for system-specific hardware functionality) exceeding unit norm.	Lower the amplitudes of the input pulses.
8041	An amplitude was requested with a norm of greater than 1.	Lower the amplitudes of the input pulses.
8042	The input pulse had some parameters which were not validated. This can be because certain parameters are expected to be real, while others are complex. It may also be due to the amplitude or duration of the pulse exceeding a limit, or other invalid combinations of parameters (e.g., a Gaussian square pulse with a flat-top width greater than the pulse’s total duration).	Verify the pulse input parameters.
8044	Number of samples is less than the minimum pulse width.	Verify that the duration of all pulses meets or exceeds the minimum pulse duration. If necessary and possible, you may consider zero-padding the start/end of very short pulses such that they meet or exceed the minimum duration.

9XXX ¶

Error code	Message	Solution
9999	Internal error.	Contact IBM Quantum via Slack for help.