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

# CircuitItemModel

*pydantic model* `CircuitItemModel`

[GitHub](https://github.com/Qiskit/ibm-quantum-schemas/tree/0.9.20260612/ibm_quantum_schemas/executor/version_0_1/models.py#L59-L96)

Bases: `BaseModel`

Execution specifications for a single quantum circuit.

### chunk\_size

*field*

Type: `Annotated[int, FieldInfo(annotation`

Default value: `NoneType, required=True, metadata=[Ge(ge=1)])] | Literal['auto'] = '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 [Required]`

A QPY-encoded circuit.

**Validated by**

- `cross_validate`

### circuit\_arguments

*field*

Type: `F64TensorModel [Required]`

Arguments to the parameters of the circuit.

The last axis is over `circuit.parameters`. Execution broadcasts over the preceding axes; expect one result per element of the leading shape.

**Validated by**

- `cross_validate`

### item\_type

*field*

Type: `Literal['circuit']`

Default value: `'circuit'`

The type of quantum program item.

**Validated by**

- `cross_validate`

### cross\_validate

*validator* `cross_validate`

[GitHub](https://github.com/Qiskit/ibm-quantum-schemas/tree/0.9.20260612/ibm_quantum_schemas/executor/version_0_1/models.py#L84-L96)

Check for mutual compatibility of types and shapes of attributes.

**Return type**

*Self*