notarum documentation

Every instance serves its own documentation at /docs, built from the same OpenAPI contract the API answers with — so it cannot go stale. This page is the map.

The three sources

The Official Gazette

What was published each day, by section and date. The norm as it came out. Use it when the date matters, or when you need the exact published text and its annexes.

National law — InfoLEG

The norm as it stands today, with its amendments. Use it when you know which law you want: ley 24240 finds it without a date.

Provincial law — SAIJ

What the national Gazette never publishes: 24 provinces, 81,000 norms since 1855. Filter by jurisdiction and by whether they are still in force.

Knowing which one holds your answer is half the work, so there is a route that asks all three.

The API

Read-only, JSON, with an OpenAPI contract at /v1/openapi.json.

Route	What it returns
`GET /v1/todo`	The same search across all three sources, tagged by origin
`GET /v1/ediciones/{seccion}/{fecha}`	One edition’s summary, with its notices
`GET /v1/avisos/{seccion}/{id}/{fecha}`	One notice, with its full text
`GET /v1/anexos/…`	A notice’s PDF annexes
`GET /v1/buscar`	Full-text search over the Gazette
`GET /v1/calendario/{anio}/{seccion}`	Which days had an edition
`GET /v1/nacional`	Search the 428,000 national norms
`GET /v1/nacional/{id}`	One national norm
`GET /v1/nacional/{id}/modificada-por`	Which norms amended this one
`GET /v1/nacional/{id}/modifica-a`	Which norms this one amended
`GET /v1/nacional/novedades?desde=`	What appeared since a date
`GET /v1/provincial`	Search provincial law, by province and status
`GET /v1/provincial/{id}`	One provincial norm
`GET /v1/provincial/novedades?desde=`	What appeared since a date
`GET /v1/salud`	Service status. Never closed, never rate-limited

Authentication is a bearer token created from your account. If the header arrives without the Bearer word but carrying notarum’s own ntrm_ prefix, it is accepted anyway: pasting a token over a field that already said Bearer TU_TOKEN is a mistake that costs an afternoon, and the secret is the token, not the word.

What “new” means

novedades answers what notarum had not seen before, not what is recent. The portals add old norms all the time, and a 1998 law that shows up today is news to whoever follows the catalog. Filtering by the norm’s own date would miss those silently. The response also says whether the record reaches back far enough to answer: completo: false means the answer is incomplete, not that nothing happened.

MCP for models

An MCP server over JSON-RPC 2.0, at /mcp for a remote client or over stdio for a local one.

{
  "mcpServers": {
    "notarum": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/diegoparras/notarum:latest", "mcp"]
    }
  }
}

The tools cover the three sources: buscar_todo, edicion, aviso, buscar, calendario, rubros, nacional_buscar, nacional_norma, nacional_relaciones, nacional_tipos, provincial_buscar, provincial_norma, provincial_tipos, novedades and estado. Each one explains what is missing instead of returning an empty list — a model that gets an empty list concludes there is nothing and moves on.

Alerts

A saved search that runs after every update and delivers only what is new.

Choose a source, what to watch for, and where to send it: an n8n webhook, an Atom feed, or just your account page.
The first pass never notifies. Starting an alert on an old topic would send you everything that has existed since 1993, which is the fastest way to make you delete it.
What stops matching is forgotten, so if it comes back it is news again.
Webhook addresses pointing at private networks are refused — loopback, private ranges, link-local and the cloud metadata range — and redirects are not followed. The address is supplied by whoever creates the alert, and notarum is the one that goes out to fetch it.

Building queries

Every route in /docs has a panel that builds the query: fill in the values and it produces the URL, the curl line and a valid n8n HTTP Request node, ready to paste.

What the data actually covers

Measured against the published catalogs, not assumed:


National norms	428,380
With full text published by InfoLEG	about 7% — for the rest, the record and the link
Amendment relationships	382,373 across 103,560 norms; 3.7 on average
The most amended norm	Law 14250 (collective bargaining), 42,427
Provincial norms	81,403, across 24 jurisdictions since 1855
Gazette sections read	3 — the fourth is `.ar` domain registrations, not law

Lists of amendments are capped at the 200 most recent, with the real total always shown.