Skip to main content

Overview

Articles are the primary legal content of each framework. Every article belongs to exactly one framework, identified by its framework_slug. Use client.articles to list, fetch, and navigate them.

Methods

list()

Returns a page of article summaries for the given framework.
Parameters
ParameterTypeDefaultDescription
framework_slugstrrequiredFramework slug, e.g. "gdpr"
pageint1Page number
per_pageint20Items per page (1–100)
Returns Page[ArticleSummary]

get()

Fetch the full content of a single article, including all paragraphs.
Parameters
ParameterTypeDescription
framework_slugstrFramework slug
article_numberintArticle number within the framework
Returns Article
Fetch articles related to a given article (linked via shared requirements or tags).
Parameters
ParameterTypeDefaultDescription
framework_slugstrrequiredFramework slug
article_numberintrequiredArticle number
pageint1Page number
per_pageint20Items per page (1–100)
Returns Page[ArticleSummary]

iter()

Iterate over all articles in a framework across all pages.
Parameters — same kwargs as list() (except page). Returns Iterator[ArticleSummary]

Models

ArticleSummary

Returned by list(), related(), and iter().
FieldTypeDescription
idintInternal numeric ID
framework_slugstrParent framework slug
article_numberintArticle number within the framework
titlestr | NoneArticle heading
positionintOrdering position in the framework
paragraph_countintNumber of paragraphs
tagslist[str]Tag slugs applied to this article

Article

Returned by get(). Extends ArticleSummary with:
FieldTypeDescription
contentstr | NoneFull plain-text content of the article
paragraphslist[Paragraph]Ordered list of paragraph objects

Paragraph

FieldTypeDescription
idintInternal numeric ID
paragraph_numberstrLabel, e.g. "1", "2a", "intro"
contentstrParagraph text
positionintOrdering position within the article

Examples

Print every GDPR chapter with article titles

Fetch a specific article and display it

Find all articles tagged with a specific tag

Collect all articles into a dict for fast lookup

Use iter() when you need every article. Use list() when you only need one page or want to control pagination yourself.