Docs

API error codes¶

1XXX ¶

Error code	Message	Solution
1000	API Internal error	Retry the action. If it happens again, contact IBM Quantum via Slack for help.
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	Split the experiments into multiple jobs. The maximum number of experiments the backend supports can be found in its configuration data.
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.
1200	You are not authorized to perform this action.	Try again or contact support.
1201	Invalid credentials.	Verify your credentials and try again.
1202	Too many {} {} requests received: limit is {} per {}.	Reduce request rate and try again.
1203	Conflicting session options were specified.	Only one of session_id or start_session = true should be specified.
1204	{} exceeds the maximum number of tags than a job can have ({}={}).	Remove some tags and try again.
1205	{} exceeds the maximum number of characters a job tag can have ({}={}).	Remove some characters from the tags and try again.
1206	Invalid runtime parameter: should have both image name and tag, got {}.	Pass image_name:tag.
1207	Invalid log_level parameter: got {}.	Should be one of critical, error, warning, info or debug.
1208	Invalid job request body: {}.	Check the JSON schema.
1209	You are not authorized to specify runtime parameter: got {}.	Contact support to get access.
1210	Parameters hub, group, project and backend are required: got hub - {}, group - {}, project - {}, backend - {}.	Pass all required parameters.
1211	Program not found.	Upload program or use a different program name.
1213	Session time is less than job time.	Pass session time greater than or equal to job time.
1214	You are not authorized to run program {}.	Contact support to get access.
1215	You are not authorized to run program on backend {} or backend does not exist on this channel.	Use a different backend that is available on the channel.
1216	Backend {} not found.	Use a different backend.
1217	Session has been closed.	Reduce time between submitting subsequent jobs in a session.
1218	Instance time limit exceeded {}.	Contact instance administrator to increase limit.
1219	Error authenticating user.	Try again or contact support.
1220	Error validating runtime image parameter.	Try again or contact support.
1221	Error reading job parameters.	Try again or contact support.
1222	Error retrieving program.	Try again or contact support.
1224	Error creating job.	Try again or contact support.
1225	Error retrieving cloud service plan.	Try again or contact support.
1228	No backends available in service plan.	Try again or contact support.
1229	Backend {} is not available.	Try again or contact support.
1236	Error calculating service instance time remaining.	Try again or contact support.
1245	Error queueing job.	Try again or contact support.
1251	Error preprocessing job.	Try again or contact support.
1263	Request timed out after {} for method={}, url={}	Try again or contact support.
1276	Error postprocessing job.	Try again or contact support.

2XXX ¶

Error code	Message	Solution
2000	Backend not available for this action	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 time	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.
2309	Code 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.
2403	Missing data in HTTP request	Check your request to the endpoint.
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.
2409	Forbidden	You don’t have authority to perform the action.
2410	Service not accesible	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.
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.
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.
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.
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	Try to 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.
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.
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.
3220	Payload not valid	Change the body sent into the request. Maybe its format is wrong.
3228	Q-Object-External-Storage property is not allowed in this backend	Send the content of the Job inside of the body.
3229	QASM no longer accepted	Use Q-Object format.
3233	The job can’t be created	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.
3245	The queue is disabled	Try to use another backend.
3246	The queue is unavailable	Try to use another backend.
3248	Your job is too long	Reduce the content of the job.
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.
3254	The job is not in queue	Check the status of the job.
3255	Invalid share level	Update the share level.
3259	Not recoverable error during the job execution, please try again	Retry the action. If it happens again, contact IBM Quantum via Slack for help.
3265	Input type not allowed by device	Try to use another backend.
3300	Can not download job data	Retry the action. If it happens again, contact IBM Quantum via Slack for help.
3400	License not found	Accept the license.
3402	API key not found	Regenerate the API Token.
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.
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 some authorized provider required	Login using IBM ID.
3446	Login failed	Try to login again.
3453	The license is required	Accept the License.
3458	Reached maximum number ({{limit}}) 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 to get status from Queue	Retry the action. If it happens again, contact IBM Quantum via Slack for help.
3900	Empty response from the stats micro-service	Retry the action. If it happens again, contact IBM Quantum via Slack for help.
3905		Check the query. It is incorrect.
3909	Missing mandatory user stats info	Check the query. It is incorrect.
3911	Stats micro-service is not available	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.

4XXX ¶

Error code	Message	Solution
4001	Job is part of a session that’s been closed	Do not close the session before all jobs in it are completed
4007	Job is a legacy qobj job not supported on the target backend.	None. Only runtime jobs are supported on the target backend.

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: 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 not the final instruction	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 {} is 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 {} cycles	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	Sequence exceeded maximum allowable circuit length	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 nonnegative integer	Make the entry a positive integer.
8024	At most one acquire currently supported per acquistion 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 is 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. Please try lowering the amplitude of your input pulses.	Lower the amplitudes of the input pulses.
8041	The norm of one of the requested waveforms exceeded 1.0 for some samples. Please decrease the waveform amplitude and try again	Lower the amplitudes of the input pulses.
8042	Invalid pulse parameters for one of the waveforms. Check the amplitude limits and type constraints	Verify the pulse input parameters.
8044	Number of samples is less than the minimum pulse duration of {0} samples	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.