---
title: SamplexItemModel (latest version)
description: API reference for ibm_quantum_schemas.executor.version_0_1.SamplexItemModel in the latest version of qiskit-ibm-runtime
source: https://eu-de.quantum.cloud.ibm.com/docs/en/api/qiskit-ibm-runtime/ibm-quantum-schemas-executor-version-0-1-samplex-item-model
---

# SamplexItemModel

*pydantic model* `SamplexItemModel`

[GitHub](https://github.com/Qiskit/ibm-quantum-schemas/tree/0.10.20260723/ibm_quantum_schemas/executor/version_0_1/models.py#L99-L146)

Bases: `BaseModel`

Execution specifications for a single quantum circuit.

### chunk\_size

*field*

Type: `Annotated`\[`int`, `FieldInfo`(`annotation``=``NoneType`, `required``=``True`, `metadata``=`\[`Ge`(`ge``=``1`)])] | `Literal`\[`'auto'`]

Default value: `'auto'`

The maximum number circuit arguments to bind to the circuit per shot loop.

When `"auto"`, the number is chosen server-side with heuristics designed to optimize execution speed. A quantum program must have items where either all chunk sizes are integer-valued, or all chunk sizes are `"auto"`. Integer values are only allowed inside of session exection mode.

**Validated by**

- `cross_validate`

### circuit

*field*

Type: [`QpyModelV13ToV16`](/docs/api/qiskit-ibm-runtime/ibm-quantum-schemas-common-qpy-model-v13-to-v16 "ibm_quantum_schemas.common.qpy.QpyModelV13ToV16")

A QPY-encoded circuit.

**Validated by**

- `cross_validate`

### item\_type

*field*

Type: `Literal`\[`'samplex'`]

Default value: `'samplex'`

The type of quantum program item.

**Validated by**

- `cross_validate`

### samplex

*field*

Type: [`SamplexModelSSV1`](/docs/api/qiskit-ibm-runtime/ibm-quantum-schemas-common-samplex-model-ssv-1 "ibm_quantum_schemas.common.samplex.SamplexModelSSV1")

A JSON-encoded samplex.

**Validated by**

- `cross_validate`

### samplex\_arguments

*field*

Type: `dict`\[`str`, `bool` | `int` | [`PauliLindbladMapModel`](/docs/api/qiskit-ibm-runtime/ibm-quantum-schemas-common-pauli-lindblad-map-model "ibm_quantum_schemas.common.pauli_lindblad_map.PauliLindbladMapModel") | [`TensorModel`](/docs/api/qiskit-ibm-runtime/ibm-quantum-schemas-common-tensor-model "ibm_quantum_schemas.common.tensor.TensorModel")]

Arguments to the samplex.

**Validated by**

- `cross_validate`

### shape

*field*

Type: `list`\[`int`]

The shape of this item.

This shape must extend (via broadcasting) the implicit shape of the :attr:\~samplex\_arguments\`. The non-trivial axes it introduces enumerate randomizations.

**Validated by**

- `cross_validate`

### cross\_validate

*validator* `cross_validate`

[GitHub](https://github.com/Qiskit/ibm-quantum-schemas/tree/0.10.20260723/ibm_quantum_schemas/executor/version_0_1/models.py#L130-L146)

Check for mutual compatibility of types and shapes of attributes.

**Return type**

*Self*