Legislation

Semantic search over articles in force

Top-K vector search over articles in force on the requested date. Coverage varies by jurisdiction and is served from more than one store: Spain is indexed 100% (356k articles, voyage-3) in Postgres, while other jurisdictions — Singapore among them — are served from the vector store. Do NOT infer coverage from a jurisdiction code. When no articles are returned, noteCode tells you WHY, and the three cases are not interchangeable: NO_MATCHES (corpus searched, nothing matched the query), CORPUS_NOT_INGESTED (no corpus for this jurisdiction — retrying will not help), and COVERAGE_UNKNOWN (coverage could not be measured, e.g. the store did not answer — an empty result here is NOT evidence of absence and the call is worth retrying). A jurisdiction whose corpus is being served INCOMPLETE carries corpusParcial (the notice, in the language of the jurisdiction) and corpusParcialCode (a stable code to branch on) on EVERY response, empty or not — a partial list looks complete, so the warning cannot wait for an empty result. When such a response is also empty, noteCode carries that same code instead of CORPUS_NOT_INGESTED: the corpus was not never-ingested, part of it is parked. Today: CO → CORPUS_PARCIAL_TEMPORAL. Both fields are absent when the corpus is complete, so their presence is the signal. SCOPE: only legislation currently IN FORCE. Does not include earlier historical versions or repealed statutes.

post/api/v1/normativa/search

Request

  • Base URL: https://legal.nexusquantum.legal
  • URL: https://legal.nexusquantum.legal/api/v1/normativa/search
  • Auth: HTTP bearer

Request body

querystring required
jurisdictionstring

ISO code. REQUIRED (this field or its jurisdiccion alias) — no default (400 MISSING_JURISDICTION if both are missing, v1.28). Takes precedence over the alias if both are sent.

jurisdiccionstring

Spanish-language alias for jurisdiction.

datestring date

English twin of fecha. Either works; neither is retired.

fechastring date
top_kinteger

Example request

{
  "jurisdiction": "ES",
  "jurisdiccion": "ES"
}

Response

Top-K articles in force on the requested date, ordered by cosine similarity. Empty array + note if the jurisdiction is still on rails.

Changes

No recorded changes to this operation across all 1 revision of this API.