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:173

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`useWeeklyCache

useWeeklyCache: boolean

`Private` `Readonly`vocabularyClient

vocabularyClient: VocabularyClient

`Private` `Readonly`votingClient

votingClient: VotingClient

Methods

`Private`buildCachedCurrentMEPs

buildCachedCurrentMEPs(
    cache: {
        mepDetails: Record<
            string,
            {
                active: boolean;
                committees: string[];
                country: string;
                id: string;
                name: string;
                politicalGroup: string;
                termStart: string;
                address?: string;
                bday?: string;
                biography?: string;
                citizenship?: string;
                email?: string;
                facebook?: string;
                familyName?: string;
                givenName?: string;
                hasEmail?: string;
                hasGender?: string;
                hasHonorificPrefix?: string;
                hasMembership?: {
                    contactPoint: {
                        email?: string;
                        hasSite?: string;
                        hasTelephone?: {
                            hasValue?: (...)
                            | (...);
                            id?: (...) | (...);
                            type?: (...) | (...);
                        };
                        id?: string;
                        officeAddress?: string;
                        type?: string;
                    }[];
                    id?: string;
                    identifier?: string;
                    memberDuring?: {
                        id: string;
                        type: string;
                        endDate?: string;
                        startDate?: string;
                    };
                    membershipClassification?: string;
                    notation_codictFunctionId?: string;
                    notation_codictMandateId?: string;
                    organization?: string;
                    represents?: string[];
                    role?: string;
                    type?: string;
                }[];
                identifier?: string;
                img?: string;
                label?: string;
                notation_codictPersonId?: string;
                phone?: string;
                placeOfBirth?: string;
                roles?: string[];
                sortLabel?: string;
                termEnd?: string;
                twitter?: string;
                type?: string;
                upperFamilyName?: string;
                upperGivenName?: string;
                votingStatistics?: {
                    abstentions: number;
                    attendanceRate: number;
                    totalVotes: number;
                    votesAgainst: number;
                    votesFor: number;
                };
                website?: string;
            },
        >;
        meps: {
            active: boolean;
            committees: string[];
            country: string;
            id: string;
            name: string;
            politicalGroup: string;
            termStart: string;
            email?: string;
            termEnd?: string;
        }[];
        metadata: {
            generatedAt: string;
            schemaVersion: number;
            source: string;
            complete?: boolean;
            dataset?: "meps"
            | "corporate-bodies"
            | "controlled-vocabularies";
            detailCount?: number;
            recordCount?: number;
            scope?: "current" | "all";
            weekKey?: string;
        };
    },
): MEP[]
Parameters
- cache: {
      mepDetails: Record<
          string,
          {
              active: boolean;
              committees: string[];
              country: string;
              id: string;
              name: string;
              politicalGroup: string;
              termStart: string;
              address?: string;
              bday?: string;
              biography?: string;
              citizenship?: string;
              email?: string;
              facebook?: string;
              familyName?: string;
              givenName?: string;
              hasEmail?: string;
              hasGender?: string;
              hasHonorificPrefix?: string;
              hasMembership?: {
                  contactPoint: {
                      email?: string;
                      hasSite?: string;
                      hasTelephone?: {
                          hasValue?: (...)
                          | (...);
                          id?: (...) | (...);
                          type?: (...) | (...);
                      };
                      id?: string;
                      officeAddress?: string;
                      type?: string;
                  }[];
                  id?: string;
                  identifier?: string;
                  memberDuring?: {
                      id: string;
                      type: string;
                      endDate?: string;
                      startDate?: string;
                  };
                  membershipClassification?: string;
                  notation_codictFunctionId?: string;
                  notation_codictMandateId?: string;
                  organization?: string;
                  represents?: string[];
                  role?: string;
                  type?: string;
              }[];
              identifier?: string;
              img?: string;
              label?: string;
              notation_codictPersonId?: string;
              phone?: string;
              placeOfBirth?: string;
              roles?: string[];
              sortLabel?: string;
              termEnd?: string;
              twitter?: string;
              type?: string;
              upperFamilyName?: string;
              upperGivenName?: string;
              votingStatistics?: {
                  abstentions: number;
                  attendanceRate: number;
                  totalVotes: number;
                  votesAgainst: number;
                  votesFor: number;
              };
              website?: string;
          },
      >;
      meps: {
          active: boolean;
          committees: string[];
          country: string;
          id: string;
          name: string;
          politicalGroup: string;
          termStart: string;
          email?: string;
          termEnd?: string;
      }[];
      metadata: {
          generatedAt: string;
          schemaVersion: number;
          source: string;
          complete?: boolean;
          dataset?: "meps"
          | "corporate-bodies"
          | "controlled-vocabularies";
          detailCount?: number;
          recordCount?: number;
          scope?: "current" | "all";
          weekKey?: string;
      };
  }
Returns MEP[]
- Defined in clients/europeanParliamentClient.ts:265

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:232

`Private`filterCachedMEPsByCommittee

filterCachedMEPsByCommittee(
    meps: MEP[],
    requested: string | undefined,
    cache: {
        mepDetails: Record<
            string,
            {
                active: boolean;
                committees: string[];
                country: string;
                id: string;
                name: string;
                politicalGroup: string;
                termStart: string;
                address?: string;
                bday?: string;
                biography?: string;
                citizenship?: string;
                email?: string;
                facebook?: string;
                familyName?: string;
                givenName?: string;
                hasEmail?: string;
                hasGender?: string;
                hasHonorificPrefix?: string;
                hasMembership?: {
                    contactPoint: {
                        email?: string;
                        hasSite?: string;
                        hasTelephone?: {
                            hasValue?: (...)
                            | (...);
                            id?: (...) | (...);
                            type?: (...) | (...);
                        };
                        id?: string;
                        officeAddress?: string;
                        type?: string;
                    }[];
                    id?: string;
                    identifier?: string;
                    memberDuring?: {
                        id: string;
                        type: string;
                        endDate?: string;
                        startDate?: string;
                    };
                    membershipClassification?: string;
                    notation_codictFunctionId?: string;
                    notation_codictMandateId?: string;
                    organization?: string;
                    represents?: string[];
                    role?: string;
                    type?: string;
                }[];
                identifier?: string;
                img?: string;
                label?: string;
                notation_codictPersonId?: string;
                phone?: string;
                placeOfBirth?: string;
                roles?: string[];
                sortLabel?: string;
                termEnd?: string;
                twitter?: string;
                type?: string;
                upperFamilyName?: string;
                upperGivenName?: string;
                votingStatistics?: {
                    abstentions: number;
                    attendanceRate: number;
                    totalVotes: number;
                    votesAgainst: number;
                    votesFor: number;
                };
                website?: string;
            },
        >;
        meps: {
            active: boolean;
            committees: string[];
            country: string;
            id: string;
            name: string;
            politicalGroup: string;
            termStart: string;
            email?: string;
            termEnd?: string;
        }[];
        metadata: {
            generatedAt: string;
            schemaVersion: number;
            source: string;
            complete?: boolean;
            dataset?: "meps"
            | "corporate-bodies"
            | "controlled-vocabularies";
            detailCount?: number;
            recordCount?: number;
            scope?: "current" | "all";
            weekKey?: string;
        };
    },
): Promise<MEP[]>
Parameters
- meps: MEP[]
- requested: string | undefined
- cache: {
      mepDetails: Record<
          string,
          {
              active: boolean;
              committees: string[];
              country: string;
              id: string;
              name: string;
              politicalGroup: string;
              termStart: string;
              address?: string;
              bday?: string;
              biography?: string;
              citizenship?: string;
              email?: string;
              facebook?: string;
              familyName?: string;
              givenName?: string;
              hasEmail?: string;
              hasGender?: string;
              hasHonorificPrefix?: string;
              hasMembership?: {
                  contactPoint: {
                      email?: string;
                      hasSite?: string;
                      hasTelephone?: {
                          hasValue?: (...)
                          | (...);
                          id?: (...) | (...);
                          type?: (...) | (...);
                      };
                      id?: string;
                      officeAddress?: string;
                      type?: string;
                  }[];
                  id?: string;
                  identifier?: string;
                  memberDuring?: {
                      id: string;
                      type: string;
                      endDate?: string;
                      startDate?: string;
                  };
                  membershipClassification?: string;
                  notation_codictFunctionId?: string;
                  notation_codictMandateId?: string;
                  organization?: string;
                  represents?: string[];
                  role?: string;
                  type?: string;
              }[];
              identifier?: string;
              img?: string;
              label?: string;
              notation_codictPersonId?: string;
              phone?: string;
              placeOfBirth?: string;
              roles?: string[];
              sortLabel?: string;
              termEnd?: string;
              twitter?: string;
              type?: string;
              upperFamilyName?: string;
              upperGivenName?: string;
              votingStatistics?: {
                  abstentions: number;
                  attendanceRate: number;
                  totalVotes: number;
                  votesAgainst: number;
                  votesFor: number;
              };
              website?: string;
          },
      >;
      meps: {
          active: boolean;
          committees: string[];
          country: string;
          id: string;
          name: string;
          politicalGroup: string;
          termStart: string;
          email?: string;
          termEnd?: string;
      }[];
      metadata: {
          generatedAt: string;
          schemaVersion: number;
          source: string;
          complete?: boolean;
          dataset?: "meps"
          | "corporate-bodies"
          | "controlled-vocabularies";
          detailCount?: number;
          recordCount?: number;
          scope?: "current" | "all";
          weekKey?: string;
      };
  }
Returns Promise<MEP[]>
- Defined in clients/europeanParliamentClient.ts:303

`Private`findCachedMEPDetails

findCachedMEPDetails(
    cache: {
        mepDetails: Record<
            string,
            {
                active: boolean;
                committees: string[];
                country: string;
                id: string;
                name: string;
                politicalGroup: string;
                termStart: string;
                address?: string;
                bday?: string;
                biography?: string;
                citizenship?: string;
                email?: string;
                facebook?: string;
                familyName?: string;
                givenName?: string;
                hasEmail?: string;
                hasGender?: string;
                hasHonorificPrefix?: string;
                hasMembership?: {
                    contactPoint: {
                        email?: string;
                        hasSite?: string;
                        hasTelephone?: {
                            hasValue?: (...)
                            | (...);
                            id?: (...) | (...);
                            type?: (...) | (...);
                        };
                        id?: string;
                        officeAddress?: string;
                        type?: string;
                    }[];
                    id?: string;
                    identifier?: string;
                    memberDuring?: {
                        id: string;
                        type: string;
                        endDate?: string;
                        startDate?: string;
                    };
                    membershipClassification?: string;
                    notation_codictFunctionId?: string;
                    notation_codictMandateId?: string;
                    organization?: string;
                    represents?: string[];
                    role?: string;
                    type?: string;
                }[];
                identifier?: string;
                img?: string;
                label?: string;
                notation_codictPersonId?: string;
                phone?: string;
                placeOfBirth?: string;
                roles?: string[];
                sortLabel?: string;
                termEnd?: string;
                twitter?: string;
                type?: string;
                upperFamilyName?: string;
                upperGivenName?: string;
                votingStatistics?: {
                    abstentions: number;
                    attendanceRate: number;
                    totalVotes: number;
                    votesAgainst: number;
                    votesFor: number;
                };
                website?: string;
            },
        >;
        meps: {
            active: boolean;
            committees: string[];
            country: string;
            id: string;
            name: string;
            politicalGroup: string;
            termStart: string;
            email?: string;
            termEnd?: string;
        }[];
        metadata: {
            generatedAt: string;
            schemaVersion: number;
            source: string;
            complete?: boolean;
            dataset?: "meps"
            | "corporate-bodies"
            | "controlled-vocabularies";
            detailCount?: number;
            recordCount?: number;
            scope?: "current" | "all";
            weekKey?: string;
        };
    },
    id: string,
): MEPDetails | undefined
Parameters
- cache: {
      mepDetails: Record<
          string,
          {
              active: boolean;
              committees: string[];
              country: string;
              id: string;
              name: string;
              politicalGroup: string;
              termStart: string;
              address?: string;
              bday?: string;
              biography?: string;
              citizenship?: string;
              email?: string;
              facebook?: string;
              familyName?: string;
              givenName?: string;
              hasEmail?: string;
              hasGender?: string;
              hasHonorificPrefix?: string;
              hasMembership?: {
                  contactPoint: {
                      email?: string;
                      hasSite?: string;
                      hasTelephone?: {
                          hasValue?: (...)
                          | (...);
                          id?: (...) | (...);
                          type?: (...) | (...);
                      };
                      id?: string;
                      officeAddress?: string;
                      type?: string;
                  }[];
                  id?: string;
                  identifier?: string;
                  memberDuring?: {
                      id: string;
                      type: string;
                      endDate?: string;
                      startDate?: string;
                  };
                  membershipClassification?: string;
                  notation_codictFunctionId?: string;
                  notation_codictMandateId?: string;
                  organization?: string;
                  represents?: string[];
                  role?: string;
                  type?: string;
              }[];
              identifier?: string;
              img?: string;
              label?: string;
              notation_codictPersonId?: string;
              phone?: string;
              placeOfBirth?: string;
              roles?: string[];
              sortLabel?: string;
              termEnd?: string;
              twitter?: string;
              type?: string;
              upperFamilyName?: string;
              upperGivenName?: string;
              votingStatistics?: {
                  abstentions: number;
                  attendanceRate: number;
                  totalVotes: number;
                  votesAgainst: number;
                  votesFor: number;
              };
              website?: string;
          },
      >;
      meps: {
          active: boolean;
          committees: string[];
          country: string;
          id: string;
          name: string;
          politicalGroup: string;
          termStart: string;
          email?: string;
          termEnd?: string;
      }[];
      metadata: {
          generatedAt: string;
          schemaVersion: number;
          source: string;
          complete?: boolean;
          dataset?: "meps"
          | "corporate-bodies"
          | "controlled-vocabularies";
          detailCount?: number;
          recordCount?: number;
          scope?: "current" | "all";
          weekKey?: string;
      };
  }
- id: string
Returns MEPDetails | undefined
- Defined in clients/europeanParliamentClient.ts:256

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:988

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:975

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:1009

`Private`getCachedMEPs

getCachedMEPs(
    params: {
        abortSignal?: AbortSignal;
        active?: boolean;
        committee?: string;
        country?: string;
        group?: string;
        limit?: number;
        live?: boolean;
        offset?: number;
    },
): Promise<PaginatedResponse<MEP> | null>
Parameters
- params: {
      abortSignal?: AbortSignal;
      active?: boolean;
      committee?: string;
      country?: string;
      group?: string;
      limit?: number;
      live?: boolean;
      offset?: number;
  }
Returns Promise<PaginatedResponse<MEP> | null>
- Defined in clients/europeanParliamentClient.ts:316

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:246

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:875

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:800

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:910

getCommitteeInfo

getCommitteeInfo(
    params: {
        abbreviation?: string;
        abortSignal?: AbortSignal;
        id?: string;
        live?: boolean;
    },
): Promise<Committee>
Retrieves committee (corporate body) information by ID or abbreviation.
Parameters
- params: {
      abbreviation?: string;
      abortSignal?: AbortSignal;
      id?: string;
      live?: boolean;
  }
  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:668

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:1076

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:1100

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:1088

getCorporateBodies

getCorporateBodies(
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<Committee>>
Returns the list of all EP Corporate Bodies. EP API Endpoint: GET /corporate-bodies
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<Committee>>
- Defined in clients/europeanParliamentClient.ts:730

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:754

getCorporateBodyById

getCorporateBodyById(
bodyId: string,
options?: { abortSignal?: AbortSignal; includeMemberships?: boolean },
): Promise<Committee>
Returns a single EP Corporate Body by body ID. EP API Endpoint: GET /corporate-bodies/{body-id}
Parameters
- bodyId: string
- options: { abortSignal?: AbortSignal; includeMemberships?: boolean } = {}
Returns Promise<Committee>
- Defined in clients/europeanParliamentClient.ts:742

getCurrentCorporateBodies

getCurrentCorporateBodies(
    params?: {
        abortSignal?: AbortSignal;
        limit?: number;
        live?: boolean;
        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; live?: boolean; offset?: number } = {}
Returns Promise<PaginatedResponse<Committee>>
- Defined in clients/europeanParliamentClient.ts:697

getCurrentMEPs

getCurrentMEPs(
    params?: {
        abortSignal?: AbortSignal;
        country?: string;
        group?: string;
        limit?: number;
        live?: boolean;
        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;
      live?: boolean;
      offset?: number;
  } = {}
Returns Promise<PaginatedResponse<MEP>>
- Defined in clients/europeanParliamentClient.ts:392

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:851

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:892

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:593

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:581

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:601

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:883

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:839

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:927

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:435

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:411

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:515

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:570

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:526

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:537

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:559

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:548

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:462

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:448

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:482

getMEPDetails

getMEPDetails(
id: string,
options?: { abortSignal?: AbortSignal; live?: boolean },
): 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; live?: boolean } = {}
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:371

getMEPs

getMEPs(
    params: {
        abortSignal?: AbortSignal;
        active?: boolean;
        committee?: string;
        country?: string;
        group?: string;
        limit?: number;
        live?: boolean;
        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;
      live?: boolean;
      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:346

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:470

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:423

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:1056

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:1038

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:1068

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:859

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:784

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:901

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:867

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:824

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:812

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:919

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:499

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:956

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:1025

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:964

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:943

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:996

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:655

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:641

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:622

`Private`matchesCommittee

matchesCommittee(committees: readonly string[], requested: string): boolean
Parameters
- committees: readonly string[]
- requested: string
Returns boolean
- Defined in clients/europeanParliamentClient.ts:295

`Private`normalizeMEPIdentifier

normalizeMEPIdentifier(id: string): string
Parameters
- id: string
Returns string
- Defined in clients/europeanParliamentClient.ts:250

`Private`paginateCachedMEPs

paginateCachedMEPs(
    meps: MEP[],
    params: {
        country?: string;
        group?: string;
        limit?: number;
        offset?: number;
    },
): PaginatedResponse<MEP>
Parameters
- meps: MEP[]
- params: { country?: string; group?: string; limit?: number; offset?: number }
Returns PaginatedResponse<MEP>
- Defined in clients/europeanParliamentClient.ts:273

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:767

`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:194

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 ReadonlyuseWeeklyCache

Private ReadonlyvocabularyClient

Private ReadonlyvotingClient

Methods

PrivatebuildCachedCurrentMEPs

Parameters

Returns MEP[]

clearCache

Returns void

Example

PrivatefilterCachedMEPsByCommittee

Parameters

Returns Promise<MEP[]>

PrivatefindCachedMEPDetails

Parameters

Returns MEPDetails | undefined

getAdoptedTextById

Parameters

Returns Promise<AdoptedText>

getAdoptedTexts

Parameters

Returns Promise<PaginatedResponse<AdoptedText>>

getAdoptedTextsFeed

Parameters

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

PrivategetCachedMEPs

Parameters

Returns Promise<PaginatedResponse<MEP> | null>

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

getCorporateBodies

Parameters

Returns Promise<PaginatedResponse<Committee>>

getCorporateBodiesFeed

Parameters

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

getCorporateBodyById

`Private` `Readonly`committeeClient

`Private` `Readonly`documentClient

`Private` `Readonly`legislativeClient

`Private` `Readonly`mepClient

`Private` `Readonly`plenaryClient

`Private` `Readonly`questionClient

`Private` `Readonly`useWeeklyCache

`Private` `Readonly`vocabularyClient

`Private` `Readonly`votingClient

`Private`buildCachedCurrentMEPs

`Private`filterCachedMEPsByCommittee

`Private`findCachedMEPDetails

`Private`getCachedMEPs