Skip to main content

Overview

Articles are the primary normative units of each EU regulation. Each article belongs to one framework and may contain multiple numbered paragraphs. Articles can also be tagged and cross-referenced to related articles.

Methods

list()

Returns a page of article summaries for a framework.
Parameters
ParameterTypeDefaultDescription
frameworkSlugstringrequiredFramework slug, e.g. "gdpr"
pagenumber1Page number
perPagenumber20Items per page (1–100)
Returns Promise<Page<ArticleSummary>>

get()

Fetch the full content of a single article including all paragraphs.
Parameters
ParameterTypeDescription
frameworkSlugstringFramework slug
articleNumbernumberArticle number
Returns Promise<Article>
Fetch articles related to a given article (cross-references and thematic links).
Parameters
ParameterTypeDescription
frameworkSlugstringFramework slug
articleNumbernumberArticle number
Returns Promise<Page<ArticleSummary>>

iter()

Iterate over all articles in a framework without managing pagination.
Parameters — same options as list() (except frameworkSlug is the first positional argument and page is managed internally). Returns AsyncGenerator<ArticleSummary>

Models

ArticleSummary

Returned by list(), related(), and iter().
FieldTypeDescription
idnumberInternal numeric ID
frameworkSlugstringParent framework slug
articleNumbernumberArticle number
titlestring | nullArticle title
positionnumberDisplay order within the framework
paragraphCountnumberNumber of paragraphs
tagsTag[]Tags applied to the article

Article

Returned by get(). Extends ArticleSummary with:
FieldTypeDescription
contentstring | nullFull article text
paragraphsArticleParagraph[]Structured paragraph list

ArticleParagraph

FieldTypeDescription
paragraphRefstringParagraph reference, e.g. "1", "2a"
contentstringParagraph text
positionnumberDisplay order within the article

Example: find all articles tagged “data-breach”