Class EuropeanParliamentClient

European Parliament API Client.

Provides type-safe, high-performance access to the European Parliament Open Data Portal with comprehensive caching, rate limiting, and GDPR-compliant audit logging.

Architecture Note: This class is a thin facade; all logic lives in the bounded-context sub-clients under src/clients/ep/. The facade owns the shared LRU cache and rate-limiter and passes them to every sub-client so they all operate within the same resource budget.

Performance Targets:

P50 latency: <100ms (cached responses)
P95 latency: <200ms (cached responses)
P99 latency: <2000ms (uncached API calls)

Features:

LRU caching with 15-minute TTL (500 entry max)
Token bucket rate limiting (100 requests/minute)
GDPR Article 30 compliant audit logging
Automatic JSON-LD to internal format transformation
Type-safe API with branded types

ISMS Policy Compliance:

SC-002: Secure coding with input validation and error handling
PE-001: Performance monitoring and optimization (<200ms P95)
AU-002: Comprehensive audit logging for GDPR compliance
DP-001: Data protection and privacy by design

Example

const client = new EuropeanParliamentClient();
const meps = await client.getMEPs({ country: 'SE', limit: 20 });
console.log(`Found ${meps.total} Swedish MEPs`);

Security

All personal data access is audit logged per GDPR Article 30
Rate limiting prevents API abuse and DoS attacks
No credentials stored (EP API is public)
Cache entries sanitized to prevent injection attacks
TLS 1.3 enforced for all API communications

See

https://data.europarl.europa.eu/api/v2/ - EP Open Data Portal API
https://github.com/Hack23/ISMS-PUBLIC/blob/main/Secure_Development_Policy.md
https://gdpr-info.eu/art-30-gdpr/ - GDPR Article 30

Index

Constructors

constructor

new EuropeanParliamentClient(config?: EPClientConfig): EuropeanParliamentClient
Creates a new European Parliament API client.

Builds shared LRU cache and rate-limiter, then wires all sub-clients to use them so the whole facade operates within one resource budget.
Parameters
- config: EPClientConfig = {}
  Optional client configuration
Returns EuropeanParliamentClient
- Defined in clients/europeanParliamentClient.ts:162

Properties

`Private` `Readonly`committeeClient

committeeClient: CommitteeClient

`Private` `Readonly`documentClient

documentClient: DocumentClient

`Private` `Readonly`legislativeClient

legislativeClient: LegislativeClient

`Private` `Readonly`mepClient

mepClient: MEPClient

`Private` `Readonly`plenaryClient

plenaryClient: PlenaryClient

`Private` `Readonly`questionClient

questionClient: QuestionClient

`Private` `Readonly`vocabularyClient

vocabularyClient: VocabularyClient

`Private` `Readonly`votingClient

votingClient: VotingClient

Methods

clearCache

clearCache(): void
Clears all entries from the LRU cache.

Returns void
Example
```
client.clearCache();
const freshData = await client.getMEPs({ country: 'SE' });
```
- Defined in clients/europeanParliamentClient.ts:220

getAdoptedTextById

getAdoptedTextById(
docId: string,
options?: { abortSignal?: AbortSignal },
): Promise<AdoptedText>
Returns a single adopted text by document ID. EP API Endpoint: GET /adopted-texts/{doc-id}
Parameters
- docId: string
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<AdoptedText>
- Defined in clients/europeanParliamentClient.ts:814

getAdoptedTexts

getAdoptedTexts(
    params?: {
        abortSignal?: AbortSignal;
        limit?: number;
        offset?: number;
        year?: number;
    },
): Promise<PaginatedResponse<AdoptedText>>
Returns adopted texts. EP API Endpoint: GET /adopted-texts
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number; year?: number } = {}
Returns Promise<PaginatedResponse<AdoptedText>>
- Defined in clients/europeanParliamentClient.ts:801

getAdoptedTextsFeed

getAdoptedTextsFeed(
    params?: {
        abortSignal?: AbortSignal;
        startDate?: string;
        timeframe?: string;
        workType?: string;
    },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated adopted texts via the feed endpoint. EP API Endpoint: GET /adopted-texts/feed
Parameters
- params: {
      abortSignal?: AbortSignal;
      startDate?: string;
      timeframe?: string;
      workType?: string;
  } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/europeanParliamentClient.ts:835

getCacheStats

getCacheStats(): {
    hitRate: number;
    hits: number;
    maxSize: number;
    misses: number;
    size: number;
}
Returns cache statistics for monitoring and debugging.

All sub-clients share the same LRU cache and hit/miss counters (via EPSharedResources), so delegating to any single sub-client returns aggregate statistics across the entire facade.

Returns { hitRate: number; hits: number; maxSize: number; misses: number; size: number }
{ size, maxSize, hitRate, hits, misses }
- Defined in clients/europeanParliamentClient.ts:234

getCommitteeDocumentById

getCommitteeDocumentById(
docId: string,
options?: { abortSignal?: AbortSignal },
): Promise<LegislativeDocument>
Returns a single committee document by ID. EP API Endpoint: GET /committee-documents/{doc-id}
Parameters
- docId: string
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<LegislativeDocument>
- Defined in clients/europeanParliamentClient.ts:701

getCommitteeDocuments

getCommitteeDocuments(
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<LegislativeDocument>>
Returns committee documents. EP API Endpoint: GET /committee-documents

Note: The EP API /committee-documents endpoint does not support year. Only pagination (limit/offset) is supported.
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<LegislativeDocument>>
- Defined in clients/europeanParliamentClient.ts:626

getCommitteeDocumentsFeed

getCommitteeDocumentsFeed(
options?: { abortSignal?: AbortSignal },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated committee documents via the feed endpoint. EP API Endpoint: GET /committee-documents/feed Fixed-window feed — no parameters per OpenAPI spec.
Parameters
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/europeanParliamentClient.ts:736

getCommitteeInfo

getCommitteeInfo(
    params: {
        abbreviation?: string;
        abortSignal?: AbortSignal;
        id?: string;
    },
): Promise<Committee>
Retrieves committee (corporate body) information by ID or abbreviation.
Parameters
- params: { abbreviation?: string; abortSignal?: AbortSignal; id?: string }
  id or abbreviation
Returns Promise<Committee>
Committee information

Security
Audit logged per GDPR Article 30

Performance
Cached: <100ms P50, <200ms P95. Uncached: <2s P99

See
https://data.europarl.europa.eu/api/v2/corporate-bodies
- Defined in clients/europeanParliamentClient.ts:555

getControlledVocabularies

getControlledVocabularies(
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<Record<string, unknown>>>
Returns EP controlled vocabularies. EP API Endpoint: GET /controlled-vocabularies
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<Record<string, unknown>>>
- Defined in clients/europeanParliamentClient.ts:902

getControlledVocabulariesFeed

getControlledVocabulariesFeed(
options?: { abortSignal?: AbortSignal },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated controlled vocabularies via the feed endpoint. EP API Endpoint: GET /controlled-vocabularies/feed Fixed-window feed — no parameters per OpenAPI spec.
Parameters
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/europeanParliamentClient.ts:926

getControlledVocabularyById

getControlledVocabularyById(
vocId: string,
options?: { abortSignal?: AbortSignal },
): Promise<Record<string, unknown>>
Returns a single EP Controlled Vocabulary by ID. EP API Endpoint: GET /controlled-vocabularies/{voc-id}
Parameters
- vocId: string
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<Record<string, unknown>>
- Defined in clients/europeanParliamentClient.ts:914

getCorporateBodiesFeed

getCorporateBodiesFeed(
options?: { abortSignal?: AbortSignal },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated corporate bodies via the feed endpoint. EP API Endpoint: GET /corporate-bodies/feed Fixed-window feed — no parameters per OpenAPI spec.
Parameters
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/europeanParliamentClient.ts:580

getCurrentCorporateBodies

getCurrentCorporateBodies(
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<Committee>>
Returns the list of all current EP Corporate Bodies for today's date. EP API Endpoint: GET /corporate-bodies/show-current
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<Committee>>
- Defined in clients/europeanParliamentClient.ts:567

getCurrentMEPs

getCurrentMEPs(
    params?: {
        abortSignal?: AbortSignal;
        country?: string;
        group?: string;
        limit?: number;
        offset?: number;
    },
): Promise<PaginatedResponse<MEP>>
Returns all currently active MEPs for today's date.

Unlike getMEPs(), this uses GET /meps/show-current which returns api:country-of-representation and api:political-group in responses. Optional country and group filters are applied client-side after fetch.

EP API Endpoint: GET /meps/show-current
Parameters
- params: {
      abortSignal?: AbortSignal;
      country?: string;
      group?: string;
      limit?: number;
      offset?: number;
  } = {}
Returns Promise<PaginatedResponse<MEP>>
- Defined in clients/europeanParliamentClient.ts:284

getDocumentById

getDocumentById(
docId: string,
options?: { abortSignal?: AbortSignal },
): Promise<LegislativeDocument>
Returns a single document by ID. EP API Endpoint: GET /documents/{doc-id}
Parameters
- docId: string
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<LegislativeDocument>
- Defined in clients/europeanParliamentClient.ts:677

getDocumentsFeed

getDocumentsFeed(
options?: { abortSignal?: AbortSignal },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated documents via the feed endpoint. EP API Endpoint: GET /documents/feed Fixed-window feed — no parameters per OpenAPI spec.
Parameters
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/europeanParliamentClient.ts:718

getEventById

getEventById(
eventId: string,
options?: { abortSignal?: AbortSignal },
): Promise<EPEvent>
Returns a single EP event by ID. EP API Endpoint: GET /events/{event-id}
Parameters
- eventId: string
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<EPEvent>
- Defined in clients/europeanParliamentClient.ts:480

getEvents

getEvents(
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<EPEvent>>
Returns EP events (hearings, conferences, etc.). EP API Endpoint: GET /events

Note: The EP API /events endpoint has no date filtering. Only pagination (limit/offset) is supported.
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<EPEvent>>
- Defined in clients/europeanParliamentClient.ts:468

getEventsFeed

getEventsFeed(
    params?: {
        abortSignal?: AbortSignal;
        activityType?: string;
        startDate?: string;
        timeframe?: string;
    },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated events via the feed endpoint. EP API Endpoint: GET /events/feed
Parameters
- params: {
      abortSignal?: AbortSignal;
      activityType?: string;
      startDate?: string;
      timeframe?: string;
  } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/europeanParliamentClient.ts:488

getExternalDocumentById

getExternalDocumentById(
docId: string,
options?: { abortSignal?: AbortSignal },
): Promise<LegislativeDocument>
Returns a single external document by ID. EP API Endpoint: GET /external-documents/{doc-id}
Parameters
- docId: string
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<LegislativeDocument>
- Defined in clients/europeanParliamentClient.ts:709

getExternalDocuments

getExternalDocuments(
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<LegislativeDocument>>
Returns all External Documents. EP API Endpoint: GET /external-documents

Note: The EP API /external-documents endpoint does not support year. Only pagination (limit/offset) is supported.
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<LegislativeDocument>>
- Defined in clients/europeanParliamentClient.ts:665

getExternalDocumentsFeed

getExternalDocumentsFeed(
    params?: {
        abortSignal?: AbortSignal;
        startDate?: string;
        timeframe?: string;
        workType?: string;
    },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated external documents via the feed endpoint. EP API Endpoint: GET /external-documents/feed
Parameters
- params: {
      abortSignal?: AbortSignal;
      startDate?: string;
      timeframe?: string;
      workType?: string;
  } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/europeanParliamentClient.ts:753

getHomonymMEPs

getHomonymMEPs(
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<MEP>>
Returns homonym MEPs for the current parliamentary term. EP API Endpoint: GET /meps/show-homonyms
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<MEP>>
- Defined in clients/europeanParliamentClient.ts:322

getIncomingMEPs

getIncomingMEPs(
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<MEP>>
Returns all incoming MEPs for the current parliamentary term. EP API Endpoint: GET /meps/show-incoming
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<MEP>>
- Defined in clients/europeanParliamentClient.ts:298

getMeetingActivities

getMeetingActivities(
sittingId: string,
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<MeetingActivity>>
Returns activities linked to a specific meeting (plenary sitting). EP API Endpoint: GET /meetings/{sitting-id}/activities
Parameters
- sittingId: string
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<MeetingActivity>>
- Defined in clients/europeanParliamentClient.ts:402

getMeetingById

getMeetingById(
eventId: string,
options?: { abortSignal?: AbortSignal },
): Promise<PlenarySession>
Returns a single EP meeting by ID. EP API Endpoint: GET /meetings/{event-id}
Parameters
- eventId: string
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<PlenarySession>
- Defined in clients/europeanParliamentClient.ts:457

getMeetingDecisions

getMeetingDecisions(
sittingId: string,
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<LegislativeDocument>>
Returns decisions made in a specific meeting (plenary sitting). EP API Endpoint: GET /meetings/{sitting-id}/decisions
Parameters
- sittingId: string
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<LegislativeDocument>>
- Defined in clients/europeanParliamentClient.ts:413

getMeetingForeseenActivities

getMeetingForeseenActivities(
sittingId: string,
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<MeetingActivity>>
Returns foreseen activities linked to a specific meeting. EP API Endpoint: GET /meetings/{sitting-id}/foreseen-activities
Parameters
- sittingId: string
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<MeetingActivity>>
- Defined in clients/europeanParliamentClient.ts:424

getMeetingPlenarySessionDocumentItems

getMeetingPlenarySessionDocumentItems(
sittingId: string,
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<LegislativeDocument>>
Returns plenary session document items for a specific meeting. EP API Endpoint: GET /meetings/{sitting-id}/plenary-session-document-items
Parameters
- sittingId: string
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<LegislativeDocument>>
- Defined in clients/europeanParliamentClient.ts:446

getMeetingPlenarySessionDocuments

getMeetingPlenarySessionDocuments(
sittingId: string,
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<LegislativeDocument>>
Returns plenary session documents for a specific meeting. EP API Endpoint: GET /meetings/{sitting-id}/plenary-session-documents
Parameters
- sittingId: string
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<LegislativeDocument>>
- Defined in clients/europeanParliamentClient.ts:435

getMEPDeclarationById

getMEPDeclarationById(
docId: string,
options?: { abortSignal?: AbortSignal },
): Promise<MEPDeclaration>
Returns a single MEP declaration by document ID. EP API Endpoint: GET /meps-declarations/{doc-id}
Parameters
- docId: string
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<MEPDeclaration>
Gdpr
Declarations contain personal financial data – access is audit-logged
- Defined in clients/europeanParliamentClient.ts:349

getMEPDeclarations

getMEPDeclarations(
    params?: {
        abortSignal?: AbortSignal;
        limit?: number;
        offset?: number;
        year?: number;
    },
): Promise<PaginatedResponse<MEPDeclaration>>
Returns MEP declarations of financial interests. EP API Endpoint: GET /meps-declarations
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number; year?: number } = {}
Returns Promise<PaginatedResponse<MEPDeclaration>>
Gdpr
Declarations contain personal financial data – access is audit-logged
- Defined in clients/europeanParliamentClient.ts:335

getMEPDeclarationsFeed

getMEPDeclarationsFeed(
    params?: {
        abortSignal?: AbortSignal;
        startDate?: string;
        timeframe?: string;
        workType?: string;
    },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated MEP declarations via the feed endpoint. EP API Endpoint: GET /meps-declarations/feed
Parameters
- params: {
      abortSignal?: AbortSignal;
      startDate?: string;
      timeframe?: string;
      workType?: string;
  } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/europeanParliamentClient.ts:369

getMEPDetails

getMEPDetails(
id: string,
options?: { abortSignal?: AbortSignal },
): Promise<MEPDetails>
Retrieves detailed information about a specific MEP.

Supports numeric ID ("124936"), person URI ("person/124936"), or MEP-prefixed ID ("MEP-124936").
Parameters
- id: string
  MEP identifier in any supported format
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<MEPDetails>
Detailed MEP information

Security
Personal data access logged per GDPR Article 30

Performance
Cached: <100ms P50, <200ms P95. Uncached: <2s P99

See
https://data.europarl.europa.eu/api/v2/meps/{id}
- Defined in clients/europeanParliamentClient.ts:271

getMEPs

getMEPs(
    params: {
        abortSignal?: AbortSignal;
        active?: boolean;
        committee?: string;
        country?: string;
        group?: string;
        limit?: number;
        offset?: number;
    },
): Promise<PaginatedResponse<MEP>>
Retrieves Members of the European Parliament with filtering and pagination.
Parameters
- params: {
      abortSignal?: AbortSignal;
      active?: boolean;
      committee?: string;
      country?: string;
      group?: string;
      limit?: number;
      offset?: number;
  }
  country, group, committee, active, limit, offset
Returns Promise<PaginatedResponse<MEP>>
Paginated MEP list

Security
Personal data access logged per GDPR Article 30

Performance
Cached: <100ms P50, <200ms P95. Uncached: <2s P99

See
https://data.europarl.europa.eu/api/v2/meps
- Defined in clients/europeanParliamentClient.ts:247

getMEPsFeed

getMEPsFeed(
    params?: {
        abortSignal?: AbortSignal;
        startDate?: string;
        timeframe?: string;
    },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated MEPs via the feed endpoint. EP API Endpoint: GET /meps/feed
Parameters
- params: { abortSignal?: AbortSignal; startDate?: string; timeframe?: string } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/europeanParliamentClient.ts:357

getOutgoingMEPs

getOutgoingMEPs(
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<MEP>>
Returns all outgoing MEPs for the current parliamentary term. EP API Endpoint: GET /meps/show-outgoing
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<MEP>>
- Defined in clients/europeanParliamentClient.ts:310

getParliamentaryQuestionById

getParliamentaryQuestionById(
docId: string,
options?: { abortSignal?: AbortSignal },
): Promise<ParliamentaryQuestion>
Returns a single parliamentary question by document ID. EP API Endpoint: GET /parliamentary-questions/{doc-id}
Parameters
- docId: string
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<ParliamentaryQuestion>
- Defined in clients/europeanParliamentClient.ts:882

getParliamentaryQuestions

getParliamentaryQuestions(
    params: {
        abortSignal?: AbortSignal;
        author?: string;
        dateFrom?: string;
        dateTo?: string;
        limit?: number;
        offset?: number;
        status?: "PENDING" | "ANSWERED";
        topic?: string;
        type?: "WRITTEN" | "ORAL";
    },
): Promise<PaginatedResponse<ParliamentaryQuestion>>
Retrieves parliamentary questions with filtering by type, author, and status.
Parameters
- params: {
      abortSignal?: AbortSignal;
      author?: string;
      dateFrom?: string;
      dateTo?: string;
      limit?: number;
      offset?: number;
      status?: "PENDING" | "ANSWERED";
      topic?: string;
      type?: "WRITTEN" | "ORAL";
  }
  type, author, topic, status, dateFrom, dateTo, limit, offset
Returns Promise<PaginatedResponse<ParliamentaryQuestion>>
Paginated parliamentary questions list

Security
Audit logged per GDPR Article 30

Performance
Cached: <100ms P50, <200ms P95. Uncached: <2s P99

See
https://data.europarl.europa.eu/api/v2/parliamentary-questions
- Defined in clients/europeanParliamentClient.ts:864

getParliamentaryQuestionsFeed

getParliamentaryQuestionsFeed(
options?: { abortSignal?: AbortSignal },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated parliamentary questions via the feed endpoint. EP API Endpoint: GET /parliamentary-questions/feed Fixed-window feed — no parameters per OpenAPI spec.
Parameters
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/europeanParliamentClient.ts:894

getPlenaryDocumentById

getPlenaryDocumentById(
docId: string,
options?: { abortSignal?: AbortSignal },
): Promise<LegislativeDocument>
Returns a single plenary document by ID. EP API Endpoint: GET /plenary-documents/{doc-id}
Parameters
- docId: string
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<LegislativeDocument>
- Defined in clients/europeanParliamentClient.ts:685

getPlenaryDocuments

getPlenaryDocuments(
    params?: {
        abortSignal?: AbortSignal;
        limit?: number;
        offset?: number;
        year?: number;
    },
): Promise<PaginatedResponse<LegislativeDocument>>
Returns plenary documents. EP API Endpoint: GET /plenary-documents
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number; year?: number } = {}
Returns Promise<PaginatedResponse<LegislativeDocument>>
- Defined in clients/europeanParliamentClient.ts:610

getPlenaryDocumentsFeed

getPlenaryDocumentsFeed(
options?: { abortSignal?: AbortSignal },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated plenary documents via the feed endpoint. EP API Endpoint: GET /plenary-documents/feed Fixed-window feed — no parameters per OpenAPI spec.
Parameters
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/europeanParliamentClient.ts:727

getPlenarySessionDocumentById

getPlenarySessionDocumentById(
docId: string,
options?: { abortSignal?: AbortSignal },
): Promise<LegislativeDocument>
Returns a single plenary session document by ID. EP API Endpoint: GET /plenary-session-documents/{doc-id}
Parameters
- docId: string
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<LegislativeDocument>
- Defined in clients/europeanParliamentClient.ts:693

getPlenarySessionDocumentItems

getPlenarySessionDocumentItems(
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<LegislativeDocument>>
Returns all Plenary Session Document Items. EP API Endpoint: GET /plenary-session-documents-items
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<LegislativeDocument>>
- Defined in clients/europeanParliamentClient.ts:650

getPlenarySessionDocuments

getPlenarySessionDocuments(
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<LegislativeDocument>>
Returns plenary session documents. EP API Endpoint: GET /plenary-session-documents
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<LegislativeDocument>>
- Defined in clients/europeanParliamentClient.ts:638

getPlenarySessionDocumentsFeed

getPlenarySessionDocumentsFeed(
options?: { abortSignal?: AbortSignal },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated plenary session documents via the feed endpoint. EP API Endpoint: GET /plenary-session-documents/feed Fixed-window feed — no parameters per OpenAPI spec.
Parameters
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/europeanParliamentClient.ts:745

getPlenarySessions

getPlenarySessions(
    params: {
        abortSignal?: AbortSignal;
        dateFrom?: string;
        dateTo?: string;
        limit?: number;
        location?: string;
        offset?: number;
        year?: number;
    },
): Promise<PaginatedResponse<PlenarySession>>
Retrieves plenary sessions with date and location filtering.
Parameters
- params: {
      abortSignal?: AbortSignal;
      dateFrom?: string;
      dateTo?: string;
      limit?: number;
      location?: string;
      offset?: number;
      year?: number;
  }
  year, dateFrom, dateTo, location, limit, offset
Returns Promise<PaginatedResponse<PlenarySession>>
Paginated plenary session list

Performance
Cached: <100ms P50, <200ms P95. Uncached: <2s P99

See
https://data.europarl.europa.eu/api/v2/meetings
- Defined in clients/europeanParliamentClient.ts:386

getProcedureById

getProcedureById(
processId: string,
options?: { abortSignal?: AbortSignal },
): Promise<Procedure>
Returns a single procedure by ID. EP API Endpoint: GET /procedures/{process-id}
Parameters
- processId: string
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<Procedure>
Throws
When the procedure is not found (404)
- Defined in clients/europeanParliamentClient.ts:782

getProcedureEventById

getProcedureEventById(
    processId: string,
    eventId: string,
    options?: { abortSignal?: AbortSignal },
): Promise<EPEvent>
Returns a single event within a procedure by event ID. EP API Endpoint: GET /procedures/{process-id}/events/{event-id}
Parameters
- processId: string
  Procedure process ID
- eventId: string
  Event identifier within the procedure
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<EPEvent>
- Defined in clients/europeanParliamentClient.ts:851

getProcedureEvents

getProcedureEvents(
processId: string,
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<EPEvent>>
Returns events linked to a procedure. EP API Endpoint: GET /procedures/{process-id}/events
Parameters
- processId: string
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<EPEvent>>
- Defined in clients/europeanParliamentClient.ts:790

getProcedures

getProcedures(
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<Procedure>>
Returns legislative procedures. EP API Endpoint: GET /procedures

Note: The EP API /procedures endpoint does not support year. Only pagination (limit/offset) is supported.
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<Procedure>>
- Defined in clients/europeanParliamentClient.ts:769

getProceduresFeed

getProceduresFeed(
    params?: {
        abortSignal?: AbortSignal;
        processType?: string;
        startDate?: string;
        timeframe?: string;
    },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated procedures via the feed endpoint. EP API Endpoint: GET /procedures/feed
Parameters
- params: {
      abortSignal?: AbortSignal;
      processType?: string;
      startDate?: string;
      timeframe?: string;
  } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/europeanParliamentClient.ts:822

getSpeechById

getSpeechById(
speechId: string,
options?: { abortSignal?: AbortSignal },
): Promise<Speech>
Returns a single speech by ID. EP API Endpoint: GET /speeches/{speech-id}
Parameters
- speechId: string
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<Speech>
- Defined in clients/europeanParliamentClient.ts:542

getSpeeches

getSpeeches(
    params?: {
        abortSignal?: AbortSignal;
        dateFrom?: string;
        dateTo?: string;
        limit?: number;
        offset?: number;
    },
): Promise<PaginatedResponse<Speech>>
Returns plenary speeches. EP API Endpoint: GET /speeches

Note: The EP API /speeches endpoint does not support year. Use dateFrom/dateTo (mapped to sitting-date/sitting-date-end).
Parameters
- params: {
      abortSignal?: AbortSignal;
      dateFrom?: string;
      dateTo?: string;
      limit?: number;
      offset?: number;
  } = {}
Returns Promise<PaginatedResponse<Speech>>
- Defined in clients/europeanParliamentClient.ts:528

getVotingRecords

getVotingRecords(
    params: {
        abortSignal?: AbortSignal;
        dateFrom?: string;
        dateTo?: string;
        limit?: number;
        offset?: number;
        sessionId?: string;
        topic?: string;
    },
): Promise<PaginatedResponse<VotingRecord>>
Retrieves voting records with filtering by session, topic, and date.

The EP API returns only aggregate vote counts; per-MEP vote positions are not available from this endpoint.
Parameters
- params: {
      abortSignal?: AbortSignal;
      dateFrom?: string;
      dateTo?: string;
      limit?: number;
      offset?: number;
      sessionId?: string;
      topic?: string;
  }
  sessionId, topic, dateFrom, dateTo, limit, offset
Returns Promise<PaginatedResponse<VotingRecord>>
Paginated voting records list

Security
Audit logged per GDPR Article 30

Performance
Cached: <100ms P50, <200ms P95. Uncached: <2s P99

See
https://data.europarl.europa.eu/api/v2/meetings/{sitting-id}/vote-results
- Defined in clients/europeanParliamentClient.ts:509

searchDocuments

searchDocuments(
    params: {
        keyword: string;
        abortSignal?: AbortSignal;
        committee?: string;
        dateFrom?: string;
        dateTo?: string;
        documentType?: string;
        limit?: number;
        offset?: number;
    },
): Promise<PaginatedResponse<LegislativeDocument>>
Searches legislative documents by keyword, type, date, and committee.
Parameters
- params: {
      keyword: string;
      abortSignal?: AbortSignal;
      committee?: string;
      dateFrom?: string;
      dateTo?: string;
      documentType?: string;
      limit?: number;
      offset?: number;
  }
  keyword, documentType, dateFrom, dateTo, committee, limit, offset
Returns Promise<PaginatedResponse<LegislativeDocument>>
Paginated legislative documents list

Security
Audit logged per GDPR Article 30

Performance
Cached: <100ms P50, <200ms P95. Uncached: <2s P99

See
https://data.europarl.europa.eu/api/v2/documents
- Defined in clients/europeanParliamentClient.ts:593

`Private` `Static`buildShared

buildShared(config: EPClientConfig): EPSharedResources
Builds the shared resources object that is passed to all sub-clients. Extracted to keep the constructor complexity within ESLint limits.
Parameters
- config: EPClientConfig
  Client configuration options
Returns EPSharedResources
Shared resources for all EP sub-clients

Private
- Defined in clients/europeanParliamentClient.ts:182

Class EuropeanParliamentClient

Example

Security

See

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns EuropeanParliamentClient

Properties

Private ReadonlycommitteeClient

Private ReadonlydocumentClient

Private ReadonlylegislativeClient

Private ReadonlymepClient

Private ReadonlyplenaryClient

Private ReadonlyquestionClient

Private ReadonlyvocabularyClient

Private ReadonlyvotingClient

Methods

clearCache

Returns void

Example

getAdoptedTextById

Parameters

Returns Promise<AdoptedText>

getAdoptedTexts

Parameters

Returns Promise<PaginatedResponse<AdoptedText>>

getAdoptedTextsFeed

Parameters

Returns Promise<JSONLDResponse<Record<string, unknown>>>

getCacheStats

Returns { hitRate: number; hits: number; maxSize: number; misses: number; size: number }

getCommitteeDocumentById

Parameters

Returns Promise<LegislativeDocument>

getCommitteeDocuments

Parameters

Returns Promise<PaginatedResponse<LegislativeDocument>>

getCommitteeDocumentsFeed

Parameters

Returns Promise<JSONLDResponse<Record<string, unknown>>>

getCommitteeInfo

Parameters

Returns Promise<Committee>

Security

Performance

See

getControlledVocabularies

Parameters

Returns Promise<PaginatedResponse<Record<string, unknown>>>

getControlledVocabulariesFeed

Parameters

Returns Promise<JSONLDResponse<Record<string, unknown>>>

getControlledVocabularyById

Parameters

Returns Promise<Record<string, unknown>>

getCorporateBodiesFeed

Parameters

Returns Promise<JSONLDResponse<Record<string, unknown>>>

getCurrentCorporateBodies

Parameters

Returns Promise<PaginatedResponse<Committee>>

getCurrentMEPs

Parameters

Returns Promise<PaginatedResponse<MEP>>

getDocumentById

Parameters

Returns Promise<LegislativeDocument>

getDocumentsFeed

Parameters

Returns Promise<JSONLDResponse<Record<string, unknown>>>

getEventById

Parameters

Returns Promise<EPEvent>

getEvents

Parameters

`Private` `Readonly`committeeClient

`Private` `Readonly`documentClient

`Private` `Readonly`legislativeClient

`Private` `Readonly`mepClient

`Private` `Readonly`plenaryClient

`Private` `Readonly`questionClient

`Private` `Readonly`vocabularyClient

`Private` `Readonly`votingClient