> ## 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

> Access regulatory recitals (preamble) with the Flutter SDK.

## Overview

Recitals are the preamble sections of EU regulations. They provide context, intent, and interpretive guidance for the articles that follow.

***

## Methods

### `list()`

```dart theme={null}
Future<Page<Recital>> list(String frameworkSlug, {int? page, int? perPage})
```

### `get()`

```dart theme={null}
Future<Recital> get(String frameworkSlug, String recitalNumber)
```

### `iter()`

```dart theme={null}
Stream<Recital> iter(String frameworkSlug, {int perPage = 20})
```

***

## Model

### `Recital`

| Field           | Type      | Description       |
| --------------- | --------- | ----------------- |
| `id`            | `int`     | Internal ID       |
| `frameworkSlug` | `String`  | Parent framework  |
| `number`        | `String`  | Recital number    |
| `title`         | `String?` | Optional title    |
| `text`          | `String`  | Full text content |
| `position`      | `int`     | Ordering position |

***

## Examples

### List recitals

```dart theme={null}
final page = await client.recitals.list('gdpr');
print('${page.meta.total} GDPR recitals');
```

### Get a specific recital

```dart theme={null}
final r1 = await client.recitals.get('gdpr', '1');
print(r1.text);
```

### Auto-paginate all recitals

```dart theme={null}
await for (final r in client.recitals.iter('nis2')) {
  print('Recital ${r.number}: ${r.text.substring(0, 80)}...');
}
```