Overview
Frameworks are the top-level resource — every article, recital, requirement, and annex belongs to one. Use the client.frameworks resource to query them.
Methods
list()
Returns the first page of frameworks.
Parameters
| Parameter | Type | Default | Description |
|---|
page | int | 1 | Page number |
per_page | int | 20 | Items per page (1–100) |
Returns Page[Framework]
get()
Fetch a single framework by its slug.
Parameters
| Parameter | Type | Description |
|---|
slug | str | Framework slug, e.g. "gdpr", "cra", "nis2" |
Returns FrameworkDetail
iter()
Iterate over every framework across all pages without manual pagination.
Parameters — same kwargs as list() (except page, which is managed internally).
Returns Iterator[Framework]
Models
Framework
Returned by list() and iter().
| Field | Type | Description |
|---|
id | int | Internal numeric ID |
slug | str | URL-safe identifier, e.g. "gdpr" |
name | str | Full official name |
short_name | str | Abbreviated name, e.g. "GDPR" |
celex_number | str | None | EUR-Lex CELEX identifier |
description | str | None | Plain-text summary |
is_active | bool | Whether the framework is in force |
status | str | "active", "draft", or "superseded" |
expected_articles | int | None | Known article count from official text |
expected_recitals | int | None | Known recital count |
last_synced_at | str | None | ISO 8601 timestamp of last data sync |
created_at | str | ISO 8601 timestamp of record creation |
article_count | int | Articles currently in the database |
recital_count | int | Recitals currently in the database |
FrameworkDetail
Returned by get(). Extends Framework with:
| Field | Type | Description |
|---|
eurlex_url | str | None | Canonical EUR-Lex URL |
requirement_count | int | Parsed compliance requirements |
annex_count | int | Annexes in the database |
tag_count | int | Tags applied to this framework’s content |
coverage | dict | Sync coverage statistics |
Examples
Print a framework summary table
Filter active frameworks only
Inspect a framework’s coverage
Look up a framework by short name
Framework slugs are stable identifiers — safe to hardcode in your application. They will not change between API versions.
Some frameworks have status="superseded" (e.g. NIS1). The data is still accessible and browsable, but these frameworks are no longer in force.