---
title: PrimitiveResult (v2.4)
description: API reference for qiskit.primitives.PrimitiveResult in qiskit v2.4
source: https://eu-de.quantum.cloud.ibm.com/docs/en/api/qiskit/2.4/qiskit.primitives.PrimitiveResult
---

# PrimitiveResult

*class* `qiskit.primitives.PrimitiveResult(pub_results, metadata=None)`

[GitHub](https://github.com/Qiskit/qiskit/tree/stable/2.4/qiskit/primitives/containers/primitive_result.py#L25-L71)

Bases: [`Generic`](https://docs.python.org/3/library/typing.html#typing.Generic)\[`T`]

A container for multiple pub results and global metadata.

This is the return value from any V2 primitive’s `run().result()`. This object corresponds to the *entire* execution, not any single pub; it does not contain any actual data, but may contain freeform [`metadata`](#qiskit.primitives.PrimitiveResult.metadata "qiskit.primitives.PrimitiveResult.metadata") returned by the primitive implementer about the entire submission (as opposed to [`PubResult.metadata`](/docs/api/qiskit/2.4/qiskit.primitives.PubResult#metadata "qiskit.primitives.PubResult.metadata"), which is metadata about a single pub).

You access the actual data of each individual pub either by iterating through this object (`for pub_result in primitive_result: ...`), or by direct list-like index access `pub_result = primitive_result[0]`. The type of each individual pub result is [`PubResult`](/docs/api/qiskit/2.4/qiskit.primitives.PubResult "qiskit.primitives.PubResult"), or potentially a primitive- and implementation-specific subclass of that.

Most likely, if you submitted a single pub to a primitive like:

```python
primitive_result = primitive.run([(qc,)]).result()
```

then the data you care about is in `primitive_result[0].data`, which is a [`DataBin`](/docs/api/qiskit/2.4/qiskit.primitives.DataBin "qiskit.primitives.DataBin"). The object `primitive_result[0]` is a [`PubResult`](/docs/api/qiskit/2.4/qiskit.primitives.PubResult "qiskit.primitives.PubResult").

**Parameters**

- **pub\_results** (*Iterable\[T]*) – Pub results.
- **metadata** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict)*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str)*, Any] | None*) – Metadata that is common to all pub results; metadata specific to particular pubs should be placed in their metadata fields. Keys are expected to be strings.

## Attributes

### metadata

The metadata of this primitive result.