Interface LegislativeDocument

European Parliament legislative document.

Represents official parliamentary documents including reports, resolutions, opinions, amendments, and legislative proposals. Documents are produced by committees, MEPs, or submitted by external institutions (Commission, Council). All documents follow strict formatting and reference standards.

Document Reference System:

A9-0123/2024: Report (A series = committee reports)
B9-0456/2024: Motion for resolution (B series)
P9_TA(2024)0789: Adopted text (TA = texts adopted)
COM(2024)123: Commission proposal

Data Source: EP API /documents

LegislativeDocument

Example

const report: LegislativeDocument = {
  id: "A9-0123/2024",
  type: "REPORT",
  title: "Report on the proposal for a regulation on digital services",
  date: "2024-11-15",
  authors: ["person/124936"],
  committee: "COMM-IMCO",
  status: "ADOPTED",
  pdfUrl: "https://www.europarl.europa.eu/doceo/document/A-9-2024-0123_EN.pdf",
  xmlUrl: "https://www.europarl.europa.eu/doceo/document/A-9-2024-0123_EN.xml",
  summary: "The committee recommends approval with amendments..."
};

Example

// Commission proposal
const proposal: LegislativeDocument = {
  id: "COM(2024)789",
  type: "REGULATION",
  title: "Proposal for a Regulation on artificial intelligence",
  date: "2024-10-01",
  authors: ["European Commission"],
  status: "IN_COMMITTEE"
};

See

DocumentType for document type enumeration
DocumentStatus for status values
Committee for responsible committee
https://www.europarl.europa.eu/doceo/

interface LegislativeDocument {
    authors: string[];
    date: string;
    id: string;
    status: DocumentStatus;
    title: string;
    type: DocumentType;
    committee?: string;
    pdfUrl?: string;
    summary?: string;
    xmlUrl?: string;
}

Index

Properties

authors date id status title type committee? pdfUrl? summary? xmlUrl?

Properties

authors

authors: string[]

Document authors.

Array of author identifiers (MEP IDs for parliamentary documents, institution names for external documents). For committee reports, includes rapporteur and shadow rapporteurs. For resolutions, includes co-signers.

EP API Field: authors Format: MEP IDs (format: "person/{id}") or institution names

Example

["person/124936", "person/198765"] // MEP authors

Example

["European Commission"] // Institutional author

Example

["person/124936"] // Single rapporteur

See

MEP for MEP author details

date

date: string

Document publication date.

Date when the document was officially published or submitted in ISO 8601 format. For reports, this is typically the adoption date by the committee.

EP API Field: date Format: ISO 8601 date (YYYY-MM-DD) Validation: Must be valid date, typically after 1952-07-23

Example

"2024-11-15"

Example

"2024-10-01"

id

id: string

Unique document identifier.

EP document reference following official numbering system. Format varies by document type and series.

EP API Field: reference

Formats:

A9-{number}/{year} - Committee reports
B9-{number}/{year} - Motions for resolution
P9_TA({year}){number} - Adopted texts
COM({year}){number} - Commission proposals
{year}/{number}(COD) - Procedure references

Example

"A9-0123/2024" // Committee report

Example

"B9-0456/2024" // Motion for resolution

Example

"P9_TA(2024)0789" // Adopted text

Example

"COM(2024)123" // Commission proposal

status

status: DocumentStatus

Document status in legislative process.

Current procedural status indicating where the document is in the legislative workflow. Status progression varies by document type and legislative procedure.

EP API Field: status

See

DocumentStatus for all valid values and workflow

Example

"ADOPTED"

Example

"IN_COMMITTEE"

Example

"PLENARY"

title

title: string

Document title.

Full official title in English. Titles follow standardized format based on document type. May include procedure reference and committee abbreviation. Other languages available through EP API.

EP API Field: title Language: English (multilingual in API) Max Length: Typically 100-500 characters

Example

"Report on the proposal for a regulation of the European Parliament and of the Council on digital services (Digital Services Act)"

Example

"Motion for a resolution on the situation of human rights in Country X"

Example

"Draft opinion on the 2025 budget"

type

type: DocumentType

Document type classification.

Categorizes the document by its legal and procedural nature. Determines workflow, voting requirements, and legal effect.

EP API Field: type

See

DocumentType for all valid values and descriptions

Example

"REPORT"

Example

"RESOLUTION"

Example

"REGULATION"

`Optional`committee

committee?: string

Responsible committee.

Committee ID of the responsible committee handling the document. For legislative procedures, this is the lead committee. Documents may also have opinion-giving committees (not captured here).

EP API Field: committee Format: Committee ID (format: "COMM-{ABBREV}")

Example

"COMM-IMCO" // Internal Market committee

Example

"COMM-ENVI" // Environment committee

See

Committee for committee details

`Optional`pdfUrl

pdfUrl?: string

PDF document URL.

Direct link to PDF version of the document. PDFs are the official format for archival and legal purposes. URLs point to EP document repository (doceo).

EP API Field: pdfUrl Format: Full HTTPS URL Domain: www.europarl.europa.eu/doceo/

Example

"https://www.europarl.europa.eu/doceo/document/A-9-2024-0123_EN.pdf"

Example

"https://www.europarl.europa.eu/doceo/document/B-9-2024-0456_EN.pdf"

`Optional`summary

summary?: string

Document summary or abstract.

Brief summary of document content, recommendations, or key points. Typically 100-500 characters. For reports, may include committee recommendation. For resolutions, includes main demands.

EP API Field: summary Format: Plain text Max Length: Typically 500 characters

Example

"The committee recommends approval of the Commission proposal with 47 amendments, focusing on strengthening user protections and platform accountability."

Example

"Resolution calling for immediate humanitarian access and cessation of hostilities."

`Optional`xmlUrl

xmlUrl?: string

XML document URL.

Direct link to structured XML version of the document. XML format enables programmatic processing, text extraction, and metadata parsing. Follows EP XML schema.

EP API Field: xmlUrl Format: Full HTTPS URL Domain: www.europarl.europa.eu/doceo/ Schema: EP Akoma Ntoso XML

Example

"https://www.europarl.europa.eu/doceo/document/A-9-2024-0123_EN.xml"

Interface LegislativeDocument

Example

Example

See

Index

Properties

Properties

authors

Example

Example

Example

See

date

Example

Example

id

Example

Example

Example

Example

status

See

Example

Example

Example

title

Example

Example

Example

type

See

Example

Example

Example

Optionalcommittee

Example

Example

See

OptionalpdfUrl

Example

Example

Optionalsummary

Example

Example

OptionalxmlUrl

Example

Settings

On This Page

`Optional`committee

`Optional`pdfUrl

`Optional`summary

`Optional`xmlUrl