{"openapi":"3.1.0","info":{"title":"kappa7 public-law API","version":"1.0.0","description":"Verbatim public statutes, addressed and hashed. Fetch instead of recall. No ranking, no summary."},"servers":[{"url":"https://kappa7.ai"}],"security":[{"bearer":[]}],"paths":{"/v1/index.json":{"get":{"operationId":"coverage","summary":"which jurisdictions are on the shelf","responses":{"200":{"description":"coverage card"}}}},"/v1/find":{"get":{"operationId":"findAct","summary":"title or abbreviation → act ids, a list in shelf order (exact, abbreviation, contains), not a ranking","parameters":[{"name":"jur","in":"query","required":true,"schema":{"type":"string","enum":["ad","ad.en","am","at","at.en","au","be","be.en","bg","ca","ca-regs","ca-regs.fr","ca.fr","ch","ch.en","col","cz","de","de.en","dk","dk.en","dz.fr","ee","ee.en","es","es-ccaa","es-intl","es-lower","es.en","et","et.en","eu","eu-dec","eu-intl","eu-treaties","eu.bg","eu.cs","eu.da","eu.de","eu.fi","eu.fr","eu.ga","eu.hr","eu.hu","eu.it","eu.nl","eu.pl","eu.sk","eu.sl","eu.sv","fi","fi-intl","fi.en","fi.sv","fr","fr.en","ge","ge.en","gh","gr","gr.en","hk","hk.zh","hr","ie","is","it","it.en","jp","jp.en","kr","kr.en","li","li.en","lk","lt","lu","lu.en","mt","mx","mx.en","nl","nl-cases","nl-stcrt","nl.en","no","no.en","nz","pl","pl.en","pt","pt.en","qa","qa.en","rw","rw.en","rw.fr","rw.nl","se","se.en","sk","tr","tr.en","uk","uk-eur","uk-govdoc","uk-nir","uk-sct","uk-si","uk-wls","uk_scan","us","us-ar","us-ca","us-ca-regs","us-cases","us-cfr","us-co","us-ct","us-dc","us-de","us-fl","us-fr","us-ga","us-ia","us-id","us-ks","us-ks-regs","us-ky","us-la","us-ma","us-md","us-me","us-mi","us-mn","us-mn-regs","us-mo","us-ms","us-mt","us-mt-regs","us-nc","us-nd","us-ne","us-nj","us-nm","us-nm-regs","us-nv","us-or","us-pa","us-ri","us-sc","us-tx","us-va","us-va-regs","us-vt","us-wa","us-wi","us-wv","zm","zm-regs","zm.sl"]}},{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":10,"maximum":50}}],"responses":{"200":{"description":"acts: [{id, title, match, in_force_from, repealed_on, articles, fetched, checked, url}]"},"404":{"description":"no such jurisdiction"}}}},"/v1/resolve":{"get":{"operationId":"resolve","summary":"«act title or abbreviation + unit» → the article in one GET; 300 with the find list when the act is not exact; 404 with the act's keys when the unit is not; never the closest article","parameters":[{"name":"jur","in":"query","required":true,"schema":{"type":"string","enum":["ad","ad.en","am","at","at.en","au","be","be.en","bg","ca","ca-regs","ca-regs.fr","ca.fr","ch","ch.en","col","cz","de","de.en","dk","dk.en","dz.fr","ee","ee.en","es","es-ccaa","es-intl","es-lower","es.en","et","et.en","eu","eu-dec","eu-intl","eu-treaties","eu.bg","eu.cs","eu.da","eu.de","eu.fi","eu.fr","eu.ga","eu.hr","eu.hu","eu.it","eu.nl","eu.pl","eu.sk","eu.sl","eu.sv","fi","fi-intl","fi.en","fi.sv","fr","fr.en","ge","ge.en","gh","gr","gr.en","hk","hk.zh","hr","ie","is","it","it.en","jp","jp.en","kr","kr.en","li","li.en","lk","lt","lu","lu.en","mt","mx","mx.en","nl","nl-cases","nl-stcrt","nl.en","no","no.en","nz","pl","pl.en","pt","pt.en","qa","qa.en","rw","rw.en","rw.fr","rw.nl","se","se.en","sk","tr","tr.en","uk","uk-eur","uk-govdoc","uk-nir","uk-sct","uk-si","uk-wls","uk_scan","us","us-ar","us-ca","us-ca-regs","us-cases","us-cfr","us-co","us-ct","us-dc","us-de","us-fl","us-fr","us-ga","us-ia","us-id","us-ks","us-ks-regs","us-ky","us-la","us-ma","us-md","us-me","us-mi","us-mn","us-mn-regs","us-mo","us-ms","us-mt","us-mt-regs","us-nc","us-nd","us-ne","us-nj","us-nm","us-nm-regs","us-nv","us-or","us-pa","us-ri","us-sc","us-tx","us-va","us-va-regs","us-vt","us-wa","us-wi","us-wv","zm","zm-regs","zm.sl"]}},{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"e.g. «Wet inkomstenbelasting 2001 artikel 3.18», «EStG § 16», «Employment Rights Act 1996 s.1», «BWBR0011353/3.18»"}],"responses":{"200":{"description":"article","content":{"application/json":{"schema":{"type":"object","properties":{"jurisdiction":{"type":"string"},"id":{"type":"string"},"n":{"type":"string"},"key":{"type":"string"},"address":{"type":"string"},"title":{"type":"string"},"heading":{"type":["string","null"]},"text":{"type":"string","description":"verbatim"},"sha256":{"type":"string"},"u":{"type":["string","null"],"description":"publisher URL"},"f":{"type":["string","null"],"description":"fetched"},"c":{"type":["string","null"],"description":"last checked"},"d":{"type":["string","null"],"description":"in force from"},"r":{"type":["string","null"],"description":"repealed on"},"made":{"type":"string","description":"the date the act was adopted / signed / passed, from the publisher's own field (the shelf's card names it: dates_from); absent where the publisher states none"},"published":{"type":"string","description":"the date the act appeared in the official gazette, from the publisher's own field — NOT the date it came into force"},"next_version_from":{"type":"string","description":"a change already ENACTED and dated after today: the earliest date the act's text changes (not a bill)"},"official_edition":{"type":"boolean","description":"false where the publisher states this text is not the official legal edition (official_edition_note quotes it); `status` is about language (original vs translation), not edition"},"in_force_state":{"type":"string","description":"the unit's legal state by the publisher's word (repealed, prospective, expired …); absent = the publisher states none"},"state_as_printed":{"type":"string","description":"the publisher's own word for in_force_state"},"status":{"type":"string","enum":["official","official-translation","unofficial-translation"]},"translation":{"type":"object"},"refs":{"type":"array","items":{"type":"object"}},"cited_by":{"type":"integer"},"stale":{"type":"boolean"},"cite":{"type":"string","description":"address · kind (translation status, consolidated / as enacted / as published, the act's in-force state — each where known) · sha256 · checked/fetched — the string to paste"},"aliases":{"type":"array","items":{"type":"string"}},"attribution":{"type":"string"},"held":{"type":"object","description":"present on a held shelf: the text is NOT served (reason, text_at = the publisher's link, how); sha256 and chars are of the text as read, so a copy fetched at the desk can be verified"},"chars":{"type":"integer"}}}}}},"300":{"description":"act not exact: acts[]"},"404":{"description":"unit not among the act's keys: keys[]"}}}},"/v1/articles":{"post":{"operationId":"batchArticles","summary":"up to 20 addresses → the same article objects, a 404 object in place for each miss","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"addresses":{"type":"array","maxItems":20,"items":{"type":"string"}}}}}}},"responses":{"200":{"description":"articles[], n, found"}}}},"/v1/acts/nl/{id}/versions.json":{"get":{"operationId":"versions","summary":"every published version of a Dutch act (version, from, to, changed, map: key → version holding the text)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"the publisher's id, e.g. BWBR0011353"}],"responses":{"200":{"description":"versions[]"},"404":{"description":"no history for this act"}}}},"/v1/acts/nl/{id}/at/{date}/{key}.json":{"get":{"operationId":"articleAt","summary":"the article as in force on a date (Netherlands; also /v1/acts/eu/… and /v1/acts/uk/… for acts with a history): as_of, version_in_force, text, sha256, cite","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"the publisher's id, e.g. BWBR0011353"},{"name":"date","in":"path","required":true,"schema":{"type":"string","format":"date"}},{"name":"key","in":"path","required":true,"schema":{"type":"string"},"description":"the article key from the act's index.json"}],"responses":{"200":{"description":"article at date"},"404":{"description":"not_yet_in_force | no_such_address_at_date (with keys[]) | no_history"}}}},"/v1/who/{jur}/index.json":{"get":{"operationId":"listAgents","summary":"the cast of a whole shelf: every agent (the persons, bodies and defined terms the acts name and bind) with how many acts it stands in and its mentions","parameters":[{"name":"jur","in":"path","required":true,"schema":{"type":"string","enum":["ad","ad.en","am","at","at.en","au","be","be.en","bg","ca","ca-regs","ca-regs.fr","ca.fr","ch","ch.en","col","cz","de","de.en","dk","dk.en","dz.fr","ee","ee.en","es","es-ccaa","es-intl","es-lower","es.en","et","et.en","eu","eu-dec","eu-intl","eu-treaties","eu.bg","eu.cs","eu.da","eu.de","eu.fi","eu.fr","eu.ga","eu.hr","eu.hu","eu.it","eu.nl","eu.pl","eu.sk","eu.sl","eu.sv","fi","fi-intl","fi.en","fi.sv","fr","fr.en","ge","ge.en","gh","gr","gr.en","hk","hk.zh","hr","ie","is","it","it.en","jp","jp.en","kr","kr.en","li","li.en","lk","lt","lu","lu.en","mt","mx","mx.en","nl","nl-cases","nl-stcrt","nl.en","no","no.en","nz","pl","pl.en","pt","pt.en","qa","qa.en","rw","rw.en","rw.fr","rw.nl","se","se.en","sk","tr","tr.en","uk","uk-eur","uk-govdoc","uk-nir","uk-sct","uk-si","uk-wls","uk_scan","us","us-ar","us-ca","us-ca-regs","us-cases","us-cfr","us-co","us-ct","us-dc","us-de","us-fl","us-fr","us-ga","us-ia","us-id","us-ks","us-ks-regs","us-ky","us-la","us-ma","us-md","us-me","us-mi","us-mn","us-mn-regs","us-mo","us-ms","us-mt","us-mt-regs","us-nc","us-nd","us-ne","us-nj","us-nm","us-nm-regs","us-nv","us-or","us-pa","us-ri","us-sc","us-tx","us-va","us-va-regs","us-vt","us-wa","us-wi","us-wv","zm","zm-regs","zm.sl"]}}],"responses":{"200":{"description":"jurisdiction, acts_read, acts_with_cast, agents: [{agent, key, acts, mentions}], what"},"404":{"description":"no such address — never a neighbour"}}}},"/v1/who/{jur}/agents/{agent}.json":{"get":{"operationId":"followAgent","summary":"follow an actor into the law: one agent across the shelf — each act (id, title), its mentions there, how many articles obligate / permit / forbid / define it (gates), whom it meets","parameters":[{"name":"jur","in":"path","required":true,"schema":{"type":"string","enum":["ad","ad.en","am","at","at.en","au","be","be.en","bg","ca","ca-regs","ca-regs.fr","ca.fr","ch","ch.en","col","cz","de","de.en","dk","dk.en","dz.fr","ee","ee.en","es","es-ccaa","es-intl","es-lower","es.en","et","et.en","eu","eu-dec","eu-intl","eu-treaties","eu.bg","eu.cs","eu.da","eu.de","eu.fi","eu.fr","eu.ga","eu.hr","eu.hu","eu.it","eu.nl","eu.pl","eu.sk","eu.sl","eu.sv","fi","fi-intl","fi.en","fi.sv","fr","fr.en","ge","ge.en","gh","gr","gr.en","hk","hk.zh","hr","ie","is","it","it.en","jp","jp.en","kr","kr.en","li","li.en","lk","lt","lu","lu.en","mt","mx","mx.en","nl","nl-cases","nl-stcrt","nl.en","no","no.en","nz","pl","pl.en","pt","pt.en","qa","qa.en","rw","rw.en","rw.fr","rw.nl","se","se.en","sk","tr","tr.en","uk","uk-eur","uk-govdoc","uk-nir","uk-sct","uk-si","uk-wls","uk_scan","us","us-ar","us-ca","us-ca-regs","us-cases","us-cfr","us-co","us-ct","us-dc","us-de","us-fl","us-fr","us-ga","us-ia","us-id","us-ks","us-ks-regs","us-ky","us-la","us-ma","us-md","us-me","us-mi","us-mn","us-mn-regs","us-mo","us-ms","us-mt","us-mt-regs","us-nc","us-nd","us-ne","us-nj","us-nm","us-nm-regs","us-nv","us-or","us-pa","us-ri","us-sc","us-tx","us-va","us-va-regs","us-vt","us-wa","us-wi","us-wv","zm","zm-regs","zm.sl"]}},{"name":"agent","in":"path","required":true,"schema":{"type":"string"},"description":"the agent key from /v1/who/{jur}/index.json, e.g. werkgever"}],"responses":{"200":{"description":"agent, acts, mentions, rows: [{id, title, mentions, gates, meets}]"},"404":{"description":"no such address — never a neighbour"}}}},"/v1/who/{jur}/acts/{id}.json":{"get":{"operationId":"actCast","summary":"the cast of one act: its agents with the article numbers grouped by what the article does to the agent (obligate · permit · forbid · define · other), and which agents are named together","parameters":[{"name":"jur","in":"path","required":true,"schema":{"type":"string","enum":["ad","ad.en","am","at","at.en","au","be","be.en","bg","ca","ca-regs","ca-regs.fr","ca.fr","ch","ch.en","col","cz","de","de.en","dk","dk.en","dz.fr","ee","ee.en","es","es-ccaa","es-intl","es-lower","es.en","et","et.en","eu","eu-dec","eu-intl","eu-treaties","eu.bg","eu.cs","eu.da","eu.de","eu.fi","eu.fr","eu.ga","eu.hr","eu.hu","eu.it","eu.nl","eu.pl","eu.sk","eu.sl","eu.sv","fi","fi-intl","fi.en","fi.sv","fr","fr.en","ge","ge.en","gh","gr","gr.en","hk","hk.zh","hr","ie","is","it","it.en","jp","jp.en","kr","kr.en","li","li.en","lk","lt","lu","lu.en","mt","mx","mx.en","nl","nl-cases","nl-stcrt","nl.en","no","no.en","nz","pl","pl.en","pt","pt.en","qa","qa.en","rw","rw.en","rw.fr","rw.nl","se","se.en","sk","tr","tr.en","uk","uk-eur","uk-govdoc","uk-nir","uk-sct","uk-si","uk-wls","uk_scan","us","us-ar","us-ca","us-ca-regs","us-cases","us-cfr","us-co","us-ct","us-dc","us-de","us-fl","us-fr","us-ga","us-ia","us-id","us-ks","us-ks-regs","us-ky","us-la","us-ma","us-md","us-me","us-mi","us-mn","us-mn-regs","us-mo","us-ms","us-mt","us-mt-regs","us-nc","us-nd","us-ne","us-nj","us-nm","us-nm-regs","us-nv","us-or","us-pa","us-ri","us-sc","us-tx","us-va","us-va-regs","us-vt","us-wa","us-wi","us-wv","zm","zm-regs","zm.sl"]}},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"the publisher's id, e.g. BWBR0011353"}],"responses":{"200":{"description":"id, title, agents: {name: {mentions, articles_by_gate}}, meetings: [{a, b, n}]"},"404":{"description":"no cast for this act"}}}},"/v1/acts/{jur}/index.json":{"get":{"operationId":"listActs","summary":"the act table of one jurisdiction","parameters":[{"name":"jur","in":"path","required":true,"schema":{"type":"string","enum":["ad","ad.en","am","at","at.en","au","be","be.en","bg","ca","ca-regs","ca-regs.fr","ca.fr","ch","ch.en","col","cz","de","de.en","dk","dk.en","dz.fr","ee","ee.en","es","es-ccaa","es-intl","es-lower","es.en","et","et.en","eu","eu-dec","eu-intl","eu-treaties","eu.bg","eu.cs","eu.da","eu.de","eu.fi","eu.fr","eu.ga","eu.hr","eu.hu","eu.it","eu.nl","eu.pl","eu.sk","eu.sl","eu.sv","fi","fi-intl","fi.en","fi.sv","fr","fr.en","ge","ge.en","gh","gr","gr.en","hk","hk.zh","hr","ie","is","it","it.en","jp","jp.en","kr","kr.en","li","li.en","lk","lt","lu","lu.en","mt","mx","mx.en","nl","nl-cases","nl-stcrt","nl.en","no","no.en","nz","pl","pl.en","pt","pt.en","qa","qa.en","rw","rw.en","rw.fr","rw.nl","se","se.en","sk","tr","tr.en","uk","uk-eur","uk-govdoc","uk-nir","uk-sct","uk-si","uk-wls","uk_scan","us","us-ar","us-ca","us-ca-regs","us-cases","us-cfr","us-co","us-ct","us-dc","us-de","us-fl","us-fr","us-ga","us-ia","us-id","us-ks","us-ks-regs","us-ky","us-la","us-ma","us-md","us-me","us-mi","us-mn","us-mn-regs","us-mo","us-ms","us-mt","us-mt-regs","us-nc","us-nd","us-ne","us-nj","us-nm","us-nm-regs","us-nv","us-or","us-pa","us-ri","us-sc","us-tx","us-va","us-va-regs","us-vt","us-wa","us-wi","us-wv","zm","zm-regs","zm.sl"]}}],"responses":{"200":{"description":"id → title, dates, article count, source, fetched, checked"},"404":{"description":"no such address — never a neighbour"}}}},"/v1/acts/{jur}/{id}/index.json":{"get":{"operationId":"listAct","summary":"one act: metadata and its article list","parameters":[{"name":"jur","in":"path","required":true,"schema":{"type":"string","enum":["ad","ad.en","am","at","at.en","au","be","be.en","bg","ca","ca-regs","ca-regs.fr","ca.fr","ch","ch.en","col","cz","de","de.en","dk","dk.en","dz.fr","ee","ee.en","es","es-ccaa","es-intl","es-lower","es.en","et","et.en","eu","eu-dec","eu-intl","eu-treaties","eu.bg","eu.cs","eu.da","eu.de","eu.fi","eu.fr","eu.ga","eu.hr","eu.hu","eu.it","eu.nl","eu.pl","eu.sk","eu.sl","eu.sv","fi","fi-intl","fi.en","fi.sv","fr","fr.en","ge","ge.en","gh","gr","gr.en","hk","hk.zh","hr","ie","is","it","it.en","jp","jp.en","kr","kr.en","li","li.en","lk","lt","lu","lu.en","mt","mx","mx.en","nl","nl-cases","nl-stcrt","nl.en","no","no.en","nz","pl","pl.en","pt","pt.en","qa","qa.en","rw","rw.en","rw.fr","rw.nl","se","se.en","sk","tr","tr.en","uk","uk-eur","uk-govdoc","uk-nir","uk-sct","uk-si","uk-wls","uk_scan","us","us-ar","us-ca","us-ca-regs","us-cases","us-cfr","us-co","us-ct","us-dc","us-de","us-fl","us-fr","us-ga","us-ia","us-id","us-ks","us-ks-regs","us-ky","us-la","us-ma","us-md","us-me","us-mi","us-mn","us-mn-regs","us-mo","us-ms","us-mt","us-mt-regs","us-nc","us-nd","us-ne","us-nj","us-nm","us-nm-regs","us-nv","us-or","us-pa","us-ri","us-sc","us-tx","us-va","us-va-regs","us-vt","us-wa","us-wi","us-wv","zm","zm-regs","zm.sl"]}},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"the publisher's id, e.g. BWBR0011353"}],"responses":{"200":{"description":"act"},"404":{"description":"no such address — never a neighbour"}}}},"/v1/acts/{jur}/{id}/articles/{key}.json":{"get":{"operationId":"getArticle","summary":"one article, verbatim","parameters":[{"name":"jur","in":"path","required":true,"schema":{"type":"string","enum":["ad","ad.en","am","at","at.en","au","be","be.en","bg","ca","ca-regs","ca-regs.fr","ca.fr","ch","ch.en","col","cz","de","de.en","dk","dk.en","dz.fr","ee","ee.en","es","es-ccaa","es-intl","es-lower","es.en","et","et.en","eu","eu-dec","eu-intl","eu-treaties","eu.bg","eu.cs","eu.da","eu.de","eu.fi","eu.fr","eu.ga","eu.hr","eu.hu","eu.it","eu.nl","eu.pl","eu.sk","eu.sl","eu.sv","fi","fi-intl","fi.en","fi.sv","fr","fr.en","ge","ge.en","gh","gr","gr.en","hk","hk.zh","hr","ie","is","it","it.en","jp","jp.en","kr","kr.en","li","li.en","lk","lt","lu","lu.en","mt","mx","mx.en","nl","nl-cases","nl-stcrt","nl.en","no","no.en","nz","pl","pl.en","pt","pt.en","qa","qa.en","rw","rw.en","rw.fr","rw.nl","se","se.en","sk","tr","tr.en","uk","uk-eur","uk-govdoc","uk-nir","uk-sct","uk-si","uk-wls","uk_scan","us","us-ar","us-ca","us-ca-regs","us-cases","us-cfr","us-co","us-ct","us-dc","us-de","us-fl","us-fr","us-ga","us-ia","us-id","us-ks","us-ks-regs","us-ky","us-la","us-ma","us-md","us-me","us-mi","us-mn","us-mn-regs","us-mo","us-ms","us-mt","us-mt-regs","us-nc","us-nd","us-ne","us-nj","us-nm","us-nm-regs","us-nv","us-or","us-pa","us-ri","us-sc","us-tx","us-va","us-va-regs","us-vt","us-wa","us-wi","us-wv","zm","zm-regs","zm.sl"]}},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"the publisher's id, e.g. BWBR0011353"},{"name":"key","in":"path","required":true,"schema":{"type":"string"},"description":"the article key from the act's index.json"}],"responses":{"200":{"description":"article","content":{"application/json":{"schema":{"type":"object","properties":{"jurisdiction":{"type":"string"},"id":{"type":"string"},"n":{"type":"string"},"key":{"type":"string"},"address":{"type":"string"},"title":{"type":"string"},"heading":{"type":["string","null"]},"text":{"type":"string","description":"verbatim"},"sha256":{"type":"string"},"u":{"type":["string","null"],"description":"publisher URL"},"f":{"type":["string","null"],"description":"fetched"},"c":{"type":["string","null"],"description":"last checked"},"d":{"type":["string","null"],"description":"in force from"},"r":{"type":["string","null"],"description":"repealed on"},"made":{"type":"string","description":"the date the act was adopted / signed / passed, from the publisher's own field (the shelf's card names it: dates_from); absent where the publisher states none"},"published":{"type":"string","description":"the date the act appeared in the official gazette, from the publisher's own field — NOT the date it came into force"},"next_version_from":{"type":"string","description":"a change already ENACTED and dated after today: the earliest date the act's text changes (not a bill)"},"official_edition":{"type":"boolean","description":"false where the publisher states this text is not the official legal edition (official_edition_note quotes it); `status` is about language (original vs translation), not edition"},"in_force_state":{"type":"string","description":"the unit's legal state by the publisher's word (repealed, prospective, expired …); absent = the publisher states none"},"state_as_printed":{"type":"string","description":"the publisher's own word for in_force_state"},"status":{"type":"string","enum":["official","official-translation","unofficial-translation"]},"translation":{"type":"object"},"refs":{"type":"array","items":{"type":"object"}},"cited_by":{"type":"integer"},"stale":{"type":"boolean"},"cite":{"type":"string","description":"address · kind (translation status, consolidated / as enacted / as published, the act's in-force state — each where known) · sha256 · checked/fetched — the string to paste"},"aliases":{"type":"array","items":{"type":"string"}},"attribution":{"type":"string"},"held":{"type":"object","description":"present on a held shelf: the text is NOT served (reason, text_at = the publisher's link, how); sha256 and chars are of the text as read, so a copy fetched at the desk can be verified"},"chars":{"type":"integer"}}}}}},"404":{"description":"no such address — never a neighbour"}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}},"schemas":{"Article":{"type":"object","properties":{"jurisdiction":{"type":"string"},"id":{"type":"string"},"n":{"type":"string"},"key":{"type":"string"},"address":{"type":"string"},"title":{"type":"string"},"heading":{"type":["string","null"]},"text":{"type":"string","description":"verbatim"},"sha256":{"type":"string"},"u":{"type":["string","null"],"description":"publisher URL"},"f":{"type":["string","null"],"description":"fetched"},"c":{"type":["string","null"],"description":"last checked"},"d":{"type":["string","null"],"description":"in force from"},"r":{"type":["string","null"],"description":"repealed on"},"made":{"type":"string","description":"the date the act was adopted / signed / passed, from the publisher's own field (the shelf's card names it: dates_from); absent where the publisher states none"},"published":{"type":"string","description":"the date the act appeared in the official gazette, from the publisher's own field — NOT the date it came into force"},"next_version_from":{"type":"string","description":"a change already ENACTED and dated after today: the earliest date the act's text changes (not a bill)"},"official_edition":{"type":"boolean","description":"false where the publisher states this text is not the official legal edition (official_edition_note quotes it); `status` is about language (original vs translation), not edition"},"in_force_state":{"type":"string","description":"the unit's legal state by the publisher's word (repealed, prospective, expired …); absent = the publisher states none"},"state_as_printed":{"type":"string","description":"the publisher's own word for in_force_state"},"status":{"type":"string","enum":["official","official-translation","unofficial-translation"]},"translation":{"type":"object"},"refs":{"type":"array","items":{"type":"object"}},"cited_by":{"type":"integer"},"stale":{"type":"boolean"},"cite":{"type":"string","description":"address · kind (translation status, consolidated / as enacted / as published, the act's in-force state — each where known) · sha256 · checked/fetched — the string to paste"},"aliases":{"type":"array","items":{"type":"string"}},"attribution":{"type":"string"},"held":{"type":"object","description":"present on a held shelf: the text is NOT served (reason, text_at = the publisher's link, how); sha256 and chars are of the text as read, so a copy fetched at the desk can be verified"},"chars":{"type":"integer"}}}}}}