--- title: BackendProperties (latest version) description: API reference for qiskit_ibm_runtime.models.BackendProperties in the latest version of qiskit-ibm-runtime source: https://quantum.cloud.ibm.com/docs/en/api/qiskit-ibm-runtime/models-backend-properties --- # BackendProperties *class* `BackendProperties(backend_name, backend_version, last_update_date, qubits, gates, general, **kwargs)` [GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.48/qiskit_ibm_runtime/models/backend_properties.py#L168-L491) Bases: `object` Class representing backend properties. This holds backend properties measured by the provider. All properties which are provided optionally. These properties may describe qubits, gates, or other general properties of the backend. **Parameters** - **backend\_name** (*str*) – Backend name. - **backend\_version** (*str*) – Backend version in the form X.Y.Z. - **last\_update\_date** (*datetime.datetime | str*) – Last date/time that a property was updated. If specified as a `str`, it must be in ISO format. - **qubits** (*list*) – System qubit parameters as a list of lists of [`Nduv`](/docs/api/qiskit-ibm-runtime/models-nduv "qiskit_ibm_runtime.models.Nduv") instances - **gates** (*list*) – System gate parameters as a list of [`GateProperties`](/docs/api/qiskit-ibm-runtime/models-gate-properties "qiskit_ibm_runtime.models.GateProperties") objects - **general** (*list*) – General parameters as a list of [`Nduv`](/docs/api/qiskit-ibm-runtime/models-nduv "qiskit_ibm_runtime.models.Nduv") objects - **kwargs** (*Any*) – optional additional fields ## Methods ### faulty\_gates `faulty_gates()` [GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.48/qiskit_ibm_runtime/models/backend_properties.py#L330-L336) Return a list of faulty gates. **Return type** list ### faulty\_qubits `faulty_qubits()` [GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.48/qiskit_ibm_runtime/models/backend_properties.py#L322-L328) Return a list of faulty qubits. **Return type** list ### frequency `frequency(qubit)` [GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.48/qiskit_ibm_runtime/models/backend_properties.py#L428-L437) Return the frequency of the given qubit. **Parameters** **qubit** (*int*) – Qubit for which to return frequency of. **Returns** Frequency of the given qubit. **Return type** float ### from\_dict *classmethod* `from_dict(data)` [GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.48/qiskit_ibm_runtime/models/backend_properties.py#L233-L258) Create a new BackendProperties object from a dictionary. **Parameters** **data** (*dict*) – A dictionary representing the BackendProperties to create. It will be in the same format as output by [`to_dict()`](#qiskit_ibm_runtime.models.BackendProperties.to_dict "qiskit_ibm_runtime.models.BackendProperties.to_dict"). **Returns** The BackendProperties from the input dictionary. **Return type** *BackendPropertiesT* ### gate\_error `gate_error(gate, qubits)` [GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.48/qiskit_ibm_runtime/models/backend_properties.py#L354-L364) Return gate error estimates from backend properties. **Parameters** - **gate** (*str*) – The gate for which to get the error. - **qubits** (*int | Iterable\[int]*) – The specific qubits for the gate. **Returns** Gate error of the given gate and qubit(s). **Return type** float ### gate\_length `gate_length(gate, qubits)` [GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.48/qiskit_ibm_runtime/models/backend_properties.py#L366-L376) Return the duration of the gate in units of seconds. **Parameters** - **gate** (*str*) – The gate for which to get the duration. - **qubits** (*int | Iterable\[int]*) – The specific qubits for the gate. **Returns** Gate length of the given gate and qubit(s). **Return type** float ### gate\_property `gate_property(gate, qubits=None, name=None)` [GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.48/qiskit_ibm_runtime/models/backend_properties.py#L288-L320) Return the property of the given gate. **Parameters** - **gate** (*str*) – Name of the gate. - **qubits** (*int | Iterable\[int] | None*) – The qubit to find the property for. - **name** (*str | None*) – Optionally used to specify which gate property to return. **Returns** Gate property as a tuple of the value and the time it was measured. **Raises** **BackendPropertyError** – If the property is not found or name is specified but qubit is not. **Return type** dict\[tuple\[int, …], dict\[str, PropertyT]] | dict\[str, PropertyT] | PropertyT ### is\_gate\_operational `is_gate_operational(gate, qubits=None)` [GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.48/qiskit_ibm_runtime/models/backend_properties.py#L338-L352) Return the operational status of the given gate. **Parameters** - **gate** (*str*) – Name of the gate. - **qubits** (*int | Iterable\[int] | None*) – The qubit to find the operational status for. **Returns** Operational status of the given gate. True if the gate is operational, False otherwise. **Return type** bool ### is\_qubit\_operational `is_qubit_operational(qubit)` [GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.48/qiskit_ibm_runtime/models/backend_properties.py#L461-L473) Return the operational status of the given qubit. **Parameters** **qubit** (*int*) – Qubit for which to return operational status of. **Returns** Operational status of the given qubit. **Return type** bool ### qubit\_property `qubit_property(qubit, name=None)` [GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.48/qiskit_ibm_runtime/models/backend_properties.py#L378-L404) Return the property of the given qubit. **Parameters** - **qubit** (*int*) – The property to look for. - **name** (*str | None*) – Optionally used to specify within the hierarchy which property to return. **Returns** Qubit property as a tuple of the value and the time it was measured. **Raises** **BackendPropertyError** – If the property is not found. **Return type** dict\[str, tuple\[*Any*, *datetime*]] | tuple\[*Any*, *datetime*] ### readout\_error `readout_error(qubit)` [GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.48/qiskit_ibm_runtime/models/backend_properties.py#L439-L448) Return the readout error of the given qubit. **Parameters** **qubit** (*int*) – Qubit for which to return the readout error of. **Returns** Readout error of the given qubit. **Return type** float ### readout\_length `readout_length(qubit)` [GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.48/qiskit_ibm_runtime/models/backend_properties.py#L450-L459) Return the readout length \[sec] of the given qubit. **Parameters** **qubit** (*int*) – Qubit for which to return the readout length of. **Returns** Readout length of the given qubit. **Return type** float ### t1 `t1(qubit)` [GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.48/qiskit_ibm_runtime/models/backend_properties.py#L406-L415) Return the T1 time of the given qubit. **Parameters** **qubit** (*int*) – Qubit for which to return the T1 time of. **Returns** T1 time of the given qubit. **Return type** float ### t2 `t2(qubit)` [GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.48/qiskit_ibm_runtime/models/backend_properties.py#L417-L426) Return the T2 time of the given qubit. **Parameters** **qubit** (*int*) – Qubit for which to return the T2 time of. **Returns** T2 time of the given qubit. **Return type** float ### to\_dict `to_dict()` [GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.48/qiskit_ibm_runtime/models/backend_properties.py#L260-L280) Return a dictionary format representation of the BackendProperties. **Returns** The dictionary form of the BackendProperties. **Return type** dict