# execute

Source: https://docs.q-ctrl.com/references/fire-opal/fireopal/fireopal.execute

```python
fireopal.execute(circuits, shot_count, credentials, backend_name, parameters=None, run_options=None)
```

Submit quantum circuits for execution on a backend.

Runs one or more circuits through Fire Opal’s full error-suppression
pipeline and returns immediately with a job handle. Use this function
whenever you want to execute circuits on real hardware.

### Parameters
* **circuits** (*str* *or* *list* *[* *str* *]*) – Quantum circuit(s) as QASM 2.0 or 3.0 strings. A single string is
  treated as a batch of one circuit. Convert Qiskit `QuantumCircuit`
  objects using `qiskit.qasm2.dumps` or `qiskit.qasm3.dumps`.
* **shot_count** (*int*) – Number of measurements (shots) to take per circuit.
* **credentials** (*Credentials*) – Credentials for the target hardware provider, created using the
  appropriate helper from the [`fireopal.credentials`](https://docs.q-ctrl.com/references/fire-opal/fireopal/fireopal.credentials.md#module-fireopal.credentials) module. For
  example, use [`make_credentials_for_ibm_cloud()`](https://docs.q-ctrl.com/references/fire-opal/fireopal/fireopal.credentials.make_credentials_for_ibm_cloud.md#fireopal.credentials.make_credentials_for_ibm_cloud) for
  IBM backends.
* **backend_name** (*str*) – Name of the target backend device (for example, `"ibm_boston"`). Call
  [`show_supported_devices()`](https://docs.q-ctrl.com/references/fire-opal/fireopal/fireopal.show_supported_devices.md#fireopal.show_supported_devices) to list available names
  for your credentials.
* **parameters** (*dict* *[* *str* *,* *float* *] or* *list* *[* *dict* *[* *str* *,* *float* *]* *] or* *None* *,* *optional*) – Parameter bindings for parametric circuits. Provide a single dict to
  apply the same bindings to every circuit, or a list with one dict per
  circuit. Defaults to None.
* **run_options** (*RunOptions* *or* *None* *,* *optional*) – Provider-specific execution options, for example,
  [`IbmRunOptions`](https://docs.q-ctrl.com/references/fire-opal/fireopal/fireopal.run_options.IbmRunOptions.md#fireopal.run_options.IbmRunOptions)).
  See the [`fireopal.run_options`](https://docs.q-ctrl.com/references/fire-opal/fireopal/fireopal.run_options.md#module-fireopal.run_options) module for available classes.
  Defaults to None.
### Returns
[`FireOpalJob`](https://docs.q-ctrl.com/references/fire-opal/fireopal/fireopal.FireOpalJob.md#fireopal.FireOpalJob) – A job object whose [`result()`](https://docs.q-ctrl.com/references/fire-opal/fireopal/fireopal.FireOpalJob.result.md#fireopal.FireOpalJob.result) method returns a dictionary
containing:

  `results (list[str])`
  : Validation errors. If empty, the circuits can be submitted for execution.

  `warnings (list[str])`
  : Warnings about the circuits that do not prevent execution, but may
    impact performance. For example, a warning will be issued if a circuit’s duration
    is approaching the requested backend’s T1 limit.
