EU law · 24 official languagesArticle-level JSON · typed citation graphMCP server · Claude, Cursor, VS CodeSDKs · Python, TypeScriptFree plan · 500 credits to start
Brussels · CET
Vol. II·Section S — Solutions Desk
Cites · Cited by · Amends · Repeals

§ Citation graph API — For developers

Who cites it, who amends it: EU law as a typed graph.

Every document in LexAPI has two lists: what it cites and what cites it. Each link is an edge with a type, such as amendment, repeal or corrigendum, and a record of where it comes from.

The free plan starts with 500 credits, no card. Your API key is on the dashboard once you confirm your email.

Create a free accountQuickstart

§ 01 — Cited by

What amends or repeals an act.

You need: curl in bash or zsh, and an API key

Ask for the edges that point at a document, filtered by type. This lists what amended or repealed the 1995 Data Protection Directive. Run it with your key in place of lex_your_key.

curl
curl "https://lex-api.com/api/v1/citations/cited-by/31995L0046?citationType=amendment,repeal&limit=20" \
  -H "x-api-key: lex_your_key"
You get (abridged)
{
  "success": true,
  "targetDocument": "31995L0046",
  "totalEdges": 2,
  "citedBy": [
    {
      "id": "32003R1882",
      "documentKind": "act",
      "celexNumber": "32003R1882",
      "title": "Regulation (EC) No 1882/2003 of the European Parliament and of the Council of 29 September 2003 adapting to Council Decision 1999/468/EC the provisions relating to committees which assist the Commission …",
      "citations": [
        { "citationType": "amendment", "provenance": "cellar", "resolution": null, … }
      ],
      …
    },
    {
      "id": "32016R0679",
      "documentKind": "act",
      "celexNumber": "32016R0679",
      "title": "Regulation (EU) 2016/679 … (General Data Protection Regulation) …",
      "citations": [
        { "citationType": "repeal", "provenance": "cellar", "resolution": null, … }
      ],
      …
    }
  ],
  "relationSync": { "source": "cellar", "status": "fresh", "syncedAt": "2026-11-18T10:09:28.704Z" },
  "credits": { "operation_weight": 1, … }
}
  • Edges are grouped by citing document in citedBy[]. Each edge has a citationType and a provenance.
  • citationType takes one type or a comma-separated list. Without it you get every type.
  • Page with limit and offset until you have totalEdges rows.
  • relationSync says how fresh the amendments, corrigenda and repeals are.
  • Each list costs 1 credit, on every plan.

Cited-by reference

§ 02 — Cites

The same edge, from the other end.


/cites lists the edges that leave a document. Asked for repeals, the GDPR answers with the directive it repealed.

curl
curl "https://lex-api.com/api/v1/citations/cites/32016R0679?citationType=repeal&limit=20" \
  -H "x-api-key: lex_your_key"
You get (abridged)
{
  "success": true,
  "sourceDocument": "32016R0679",
  "totalEdges": 1,
  "cites": [
    {
      "id": "31995L0046",
      "documentKind": "act",
      "celexNumber": "31995L0046",
      "title": "Directive 95/46/EC of the European Parliament and of the Council of 24 October 1995 on the protection of individuals with regard to the processing of personal data and on the free movement of such data",
      "citations": [
        { "citationType": "repeal", "provenance": "cellar", "resolution": null, … }
      ],
      …
    }
  ],
  "credits": { "operation_weight": 1, … }
}

Same parameters and paging as /cited-by; the groups are in cites[]. A judgment’s CELEX number works too; its list holds what LexAPI has extracted.

§ 03 — Edge types

What each type means, and its source.


citationTypeMeaningComes from
amendmentThe citing act amends this one. A partial repeal is typed amendment too.Cellar, the Publications Office’s repository
corrigendumA corrigendum to this act; each is its own document.Cellar, the Publications Office’s repository
repealThe citing act repeals this one as a whole.Cellar, the Publications Office’s repository
referenceOne document refers to the other.EUR-Lex notice pages of the documents LexAPI has extracted
implementationDelegated and implementing acts EUR-Lex lists as “Completed by”, among others.EUR-Lex notice pages of the documents LexAPI has extracted
legal-basisA legal-basis relation, as the EUR-Lex notice lists it.EUR-Lex notice pages of the documents LexAPI has extracted
proposalLinks a Commission proposal and the act it concerns, both ways.EUR-Lex notice pages of the documents LexAPI has extracted
transpositionA measure a member state notified for the act. A notification, not a finding.A member state’s notification to the Commission
  • Amendments, corrigenda and repeals of legislation are read from Cellar, also for acts older than LexAPI’s own corpus.
  • The other types grow as more documents are extracted, so a short or empty list is not proof that nothing cites the act.
  • When one act both amends and corrects another, the pair has one edge with the stronger type: repeal over amendment over corrigendum.

How the graph is built

§ 04 — Graph

Further than one hop.


Three routes read the graph instead of one list. Each costs 20 credits.

RouteWhat it returns
GET /citations/network/:celexNumberBoth directions of the graph in one call, with counts by citation type.
GET /citations/path/:from/:toThe shortest citation path from one document to another.
GET /citations/related/:celexNumberThe documents that share the most citation targets with one document.

Graph endpoints reference

§ 05 — SDKs and MCP

The cited-by call with the SDKs.


Install with pip install lexapi-client or npm install @lexapi/client.

Python
from lexapi import LexAPI

client = LexAPI(api_key="lex_your_key")

resp = client.citations.cited_by("31995L0046", citation_type=["amendment", "repeal"], limit=20)

for group in resp.cited_by:
    for edge in group.citations:
        print(edge.citation_type, group.celex_number, edge.provenance)
TypeScript
import { LexAPI } from "@lexapi/client";

const client = new LexAPI({ apiKey: "lex_your_key" });

const resp = await client.getCitedBy("31995L0046", {
  citationType: ["amendment", "repeal"],
  limit: 20,
});

for (const group of resp.citedBy) {
  for (const edge of group.citations ?? []) {
    console.log(edge.citationType, group.celexNumber, edge.provenance);
  }
}
Both print
amendment 32003R1882 cellar
repeal 32016R0679 cellar

In an MCP client the two lists are the tools lex_cited_by and lex_cites. A prompt to try: Using LexAPI, list the acts that amended or repealed Directive 95/46/EC (CELEX 31995L0046).

MCP setup for agents

§ 06 — FAQ

Asked & answered.

N° 01What types of link does the LexAPI citation graph hold?+
reference, amendment, repeal, corrigendum, implementation, legal-basis, proposal and transposition. Every edge carries its type in citationType and where it comes from in provenance.
N° 02How do I list the acts that amend an EU regulation or directive?+
Call GET /api/v1/citations/cited-by/{CELEX number} with citationType=amendment. Each group in the answer is an amending act, with its CELEX number and title. Amendments, corrigenda and repeals of legislation come from the Publications Office’s Cellar repository.
N° 03Is a citation list complete?+
A list is not proof of completeness. Amendments, corrigenda and repeals are as current as the last refresh from Cellar, which relationSync reports. The other edge types come from the documents LexAPI has extracted, not the whole of EUR-Lex, so a short or empty list is not proof that nothing cites the act.
N° 04Does a repeal edge cover a partial repeal?+
No. repeal means the whole act. A partial repeal, or a replacement of part of an act, is typed amendment.
§ 07 — Next

Keep building.


  • CELEX, ELI & ECLI resolverTurn an ECLI, an ELI or a pasted EUR-Lex link into a CELEX number, and see whether the match was confirmed.
  • EU law change monitoringA signed webhook when a watched act is amended, corrected, repealed or consolidated.
  • GDPR APIRead the GDPR by article or recital, cite it, and list what corrects or amends it.
  • QuickstartA first request by curl, MCP, Python and TypeScript.
  • API referenceEvery endpoint, parameter, response field and error.
  • MCP serverSetup for Claude, Cursor and VS Code, and the tool list.
  • PricingPlans, credit pools and what each call costs.

LexAPI returns source texts and their identifiers. It does not assess compliance and gives no legal advice.