> ## Documentation Index
> Fetch the complete documentation index at: https://docs.law4devs.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Recitals

> Fetch and iterate framework recitals with the Law4Devs PHP SDK.

## Overview

Recitals are the numbered preamble paragraphs of EU regulations that provide context and intent for the operative articles. Use `$client->recitals` to access them.

***

## Methods

### `list()`

Returns a page of recitals for the given framework.

```php theme={null}
$page = $client->recitals->list('gdpr', perPage: 10);

printf("GDPR has %d recitals\n", $page->meta->total);
foreach ($page->data as $recital) {
    printf("  Recital %s: %.80s...\n", $recital->recitalNumber, $recital->content);
}
```

**Returns** `Page<Recital>`

***

### `get()`

Fetch a single recital by number.

```php theme={null}
$recital = $client->recitals->get('gdpr', 1);
echo $recital->content . "\n";
```

**Returns** `Recital`

***

### `iter()`

Iterate over all recitals in a framework.

```php theme={null}
foreach ($client->recitals->iter('nis2') as $recital) {
    echo $recital->recitalNumber . ' — ' . substr($recital->content, 0, 80) . "\n";
}
```

**Returns** `\Generator<Recital>`

***

## Model

### `Recital`

| Field           | Type     | Description                         |
| --------------- | -------- | ----------------------------------- |
| `id`            | `int`    | Internal numeric ID                 |
| `frameworkSlug` | `string` | Parent framework slug               |
| `recitalNumber` | `string` | Recital number within the framework |
| `content`       | `string` | Full recital text                   |
| `position`      | `int`    | Ordering position in the framework  |