{"openapi":"3.1.0","info":{"title":"Rigsdata API","version":"2.0.0","description":"Official documents and records of one country's parliament, government, consultations and local authorities, on a country-neutral model. Field names are English; customer text (`message`, `interpretation`, labels, caveats) is in the instance language. Dates are ISO 8601 with the instance time zone's offset; days are `YYYY-MM-DD`. Ids are `{place}:{publisher}:{native-type}:{native-id}`. Guide: docs/api/v2.md."},"servers":[{"url":"https://api.rigsdata.dk"}],"security":[{"bearer":[]}],"tags":[{"name":"core.platform","description":"Platform: always on: identity of the credential, the contract."},{"name":"core.search","description":"Search: always on: the OpenSearch index families."},{"name":"core.documents","description":"Documents: always on: core.document, core.file, core.page."},{"name":"core.changes","description":"Changes: always on: the file change history."},{"name":"core.matters","description":"Matters: always on: core.matter and its actions."},{"name":"core.consultations","description":"Consultations: always on: core.consultation."},{"name":"core.meetings","description":"Meetings and agenda items: always on: core.meeting, core.agenda_item, core.decision."},{"name":"local.comparison","description":"Local-authority comparison: agenda sources covering every authority of a level, with population."},{"name":"local.transparency","description":"Local-authority transparency: the derived transparency figures per authority and period."},{"name":"parliament.statistics","description":"Parliament statistics: a parliament source with votes, written questions with a deadline rule, and transcripts split into speeches."},{"name":"core.legislation","description":"Legislation: always on: core.legal_act and core.relation."},{"name":"eu.transposition","description":"EU transposition: a source linking national acts to the EU directives they transpose."},{"name":"government.legislative-programme","description":"Government legislative programme: a source that publishes the government's programme of bills per session."},{"name":"procurement","description":"Procurement: a procurement source mapped to core.procurement_notice (TED, a national portal)."},{"name":"rulings","description":"Rulings: a source of board decisions mapped to core.ruling (råd og nævn, the Ombudsman)."},{"name":"consultation.stakeholders","description":"Stakeholders and consultation influence: consultation responses attributed to organisations, and read consultation memos."},{"name":"text-reuse","description":"Text reuse: text-reuse fingerprints over the files."},{"name":"trends","description":"Trends: the nightly term-frequency lists."},{"name":"core.coverage","description":"Coverage: always on: the coverage snapshots."},{"name":"core.attestations","description":"Attestations: always on: the audit log."},{"name":"core.calendars","description":"Deadlines and calendars: always on: dated rows of core."},{"name":"core.dossiers","description":"Dossiers: always on: app.dossier."},{"name":"core.exports","description":"Exports: always on: object storage for the files."},{"name":"core.mail","description":"Assistant mail: always on: SMTP (SMTP_HOST, ASSISTANT_MAIL_FROM or EMAIL_FROM) and BETTER_AUTH_SECRET (else 503 mail_unavailable)."},{"name":"core.alerts","description":"Alerts: always on: the API scheduler's alerts task every 15 minutes, and SMTP and BETTER_AUTH_SECRET for its mail (as core.mail)."},{"name":"core.feedback","description":"Customer feedback: always on: app.feedback."}],"paths":{"/v2/whoami":{"get":{"operationId":"whoami","summary":"Who the key or token belongs to","description":"Verifies the credential and answers with its organisation. Neither metered nor audited, and not counted against the plan (the MCP service's key check).","tags":["core.platform"],"x-capability":"core.platform","x-replaces":["GET /v1/whoami"],"x-mcp-tools":[],"x-reads":{"core":[],"app":["apikey","api_key_policy"]},"parameters":[],"responses":{"200":{"description":"The credential's organisation. Not metered, not audited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WhoamiResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/resolve/{id}":{"get":{"operationId":"resolveId","summary":"What an id names, and the route that reads it","description":"Answers the entity type of any public id (an entity, a file or a recorded change) and its detail route. Tools and clients pass ids back without knowing their kind; this is how they find the route. Another source's entity for a restricted key answers 404 like a missing id.","tags":["core.platform"],"x-capability":"core.platform","x-replaces":[],"x-mcp-tools":[],"x-reads":{"core":["matter","document","publication","legal_act","consultation","meeting","agenda_item","organization","person"],"derived":["file_change"]},"parameters":[{"name":"id","in":"path","required":true,"description":"Any public id: an entity (`dk:folketing:sag:106086`), a file or a change.","schema":{"type":"string","maxLength":512}}],"responses":{"200":{"description":"What an id names and the route to read it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/openapi.json":{"get":{"operationId":"openapi","summary":"The OpenAPI 3.1 document of /v2","tags":["core.platform"],"x-capability":"core.platform","x-replaces":["GET /v1/openapi.json"],"x-mcp-tools":[],"x-reads":{"core":[]},"security":[],"parameters":[],"responses":{"200":{"description":"The OpenAPI 3.1 document of /v2.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenApiDocument"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/search":{"get":{"operationId":"search","summary":"Full-text and semantic search across every source","description":"Searches the text of every document page and every field of every record (matters, consultations, meetings, agenda items, speeches, legal acts, publications). One item per document by default, best match first. An empty first page is retried once with a broader query; `interpretation` says so.","tags":["core.search"],"x-capability":"core.search","x-replaces":["GET /v1/search"],"x-mcp-tools":["search"],"x-reads":{"core":["document","publication","matter","consultation","agenda_item","speech","legal_act","file","page"],"derived":["summary"],"indices":["pages","matters","consultations","agenda-items","speeches","legal-acts","publications"]},"x-coverage":true,"parameters":[{"name":"q","in":"query","required":false,"description":"Search text in the search syntax: plain words are all required (word forms of the instance language), \"exact phrase\", wildcards `skat*`/`kommun?`, `skat~` (fuzzy), `OR`, `-word` to exclude. Optional when at least one filter is given (`source`, `entity_type`, `document_type`, `document_type_native`, `authority`, `publisher`, `jurisdiction`, `from_date`, `to_date`): without it the answer lists the newest documents the filters match (`sort` is `newest`, `group` `document`). Neither q nor a filter is `400 invalid_query`.","schema":{"type":"string","maxLength":500}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}},{"name":"source","in":"query","required":false,"description":"One or more source slugs (repeated or comma-separated). Omit for every source the key may read.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"entity_type","in":"query","required":false,"description":"Only these entity types (documents, matters, consultations, agenda items, ...).","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":10,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"document_type","in":"query","required":false,"description":"Vocabulary codes, e.g. `bill-text`, `answer`, `consultation-memo`, `minutes`.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"document_type_native","in":"query","required":false,"description":"The upstream type exactly as in `document_type_native` of a result.","schema":{"type":"string","maxLength":200}},{"name":"authority","in":"query","required":false,"description":"Authority (publisher or organiser): an organization id, or (part of) its name; an exact name wins over names that only contain it.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"publisher","in":"query","required":false,"description":"Organization ids of publishers (a party, a ministry): replaces v1 `party`/`ministry`.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"jurisdiction","in":"query","required":false,"description":"Jurisdictions: ids such as `dk:kommune-0101`, or exact names; `filters.jurisdictions_resolved` echoes the ids used.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":100,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"from_date","in":"query","required":false,"description":"First day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"to_date","in":"query","required":false,"description":"Last day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"group","in":"query","required":false,"description":"`document`: one item per document or record; `page`: one per matching page.","schema":{"default":"document","type":"string","enum":["document","page"]}},{"name":"sort","in":"query","required":false,"schema":{"default":"relevance","type":"string","enum":["relevance","newest"]}},{"name":"mode","in":"query","required":false,"description":"`hybrid`: keyword (BM25) and semantic (vectors) fused; `keyword`: words only. Semantic search applies to `sort=relevance`, `group=document` and a query without wildcards, fuzzy terms, OR or exclusions.","schema":{"default":"hybrid","type":"string","enum":["hybrid","keyword"]}},{"name":"facets","in":"query","required":false,"description":"Count documents per value of these fields over every match (top 50 each).","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":6,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"format","in":"query","required":false,"description":"Answer with a file instead of JSON (at most 1 000 rows; larger lists: POST /v2/exports).","schema":{"type":"string","enum":["csv","xlsx"]}},{"name":"separator","in":"query","required":false,"description":"CSV field separator (default semicolon).","schema":{"type":"string","enum":["semicolon","comma"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}},"text/csv":{"schema":{"type":"string"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/documents":{"get":{"operationId":"listDocuments","summary":"Documents by date and type, newest first","description":"The documents of a body (default: the national parliament) by day, type, question kind and title, newest first, without knowing their matter: e.g. today's questions and answers with asker and minister.","tags":["core.documents"],"x-capability":"core.documents","x-replaces":["GET /v1/cases/documents"],"x-mcp-tools":["parliament_documents"],"x-reads":{"core":["document","document_matter","matter","participation","person","post","file"],"indices":["pages"]},"x-coverage":true,"parameters":[{"name":"q","in":"query","required":false,"description":"Words in the title or the text (search syntax).","schema":{"type":"string","minLength":1,"maxLength":500}},{"name":"title","in":"query","required":false,"description":"A substring of the title.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"source","in":"query","required":false,"description":"One or more source slugs (repeated or comma-separated). Omit for every source the key may read.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"body","in":"query","required":false,"description":"The body whose documents to list (default: the instance's national parliament).","schema":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$"}},{"name":"document_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"document_type_native","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"question_type","in":"query","required":false,"description":"Only questions of these kinds (matter_type codes); `all` for every kind. A bill's committee questions: `question.committee` with `matter_type=bill`.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":10,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"matter_type","in":"query","required":false,"description":"Only documents on matters of these types.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":10,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"days","in":"query","required":false,"description":"The last N days, today included (instead of from_date/to_date).","schema":{"type":"integer","minimum":1,"maximum":400}},{"name":"from_date","in":"query","required":false,"description":"First day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"to_date","in":"query","required":false,"description":"Last day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}},{"name":"format","in":"query","required":false,"description":"Answer with a file instead of JSON (at most 1 000 rows; larger lists: POST /v2/exports).","schema":{"type":"string","enum":["csv","xlsx"]}},{"name":"separator","in":"query","required":false,"description":"CSV field separator (default semicolon).","schema":{"type":"string","enum":["semicolon","comma"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListDocumentsResponse"}},"text/csv":{"schema":{"type":"string"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/documents/{id}":{"get":{"operationId":"getDocument","summary":"One document's fields, files and links","tags":["core.documents"],"x-capability":"core.documents","x-replaces":["GET /v1/documents/{id}"],"x-mcp-tools":[],"x-reads":{"core":["document","publication","legal_act","agenda_item","speech","file","document_matter","participation","meeting","relation"]},"parameters":[{"name":"id","in":"path","required":true,"description":"A document, publication or legal act id, a file id (`dk:archive:file:7`), or an agenda item's or speech's id (its own text, one page).","schema":{"anyOf":[{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$","description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is."},{"type":"string","maxLength":64,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:archive:file:[0-9]+$","description":"Public id of a stored file: `{country}:archive:file:{n}`, e.g. `dk:archive:file:7`."}]}},{"name":"from_search","in":"query","required":false,"description":"The `search_id` of the search this result was opened from. Changes nothing in the answer.","schema":{"type":"string","pattern":"^s_[A-Za-z0-9_-]{22}$"}},{"name":"rank","in":"query","required":false,"description":"The result's position in that search, 1 for the first.","schema":{"type":"integer","minimum":1,"maximum":10000}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetDocumentResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/documents/{id}/pages":{"get":{"operationId":"getDocumentPages","summary":"The text of a document's pages, at most max_chars per call","description":"Reads pages in order until `max_chars` is spent; a page longer than that is cut at a paragraph or sentence and continues at `continue_from`. Read on until `continue_from` is null before concluding what a document does not say.","tags":["core.documents"],"x-capability":"core.documents","x-replaces":["GET /v1/documents/{id}/pages"],"x-mcp-tools":["get_document"],"x-reads":{"core":["document","publication","legal_act","agenda_item","speech","file","page","relation"],"derived":["summary"]},"parameters":[{"name":"id","in":"path","required":true,"description":"A document, publication or legal act id, a file id (`dk:archive:file:7`), or an agenda item's or speech's id (its own text, one page).","schema":{"anyOf":[{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$","description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is."},{"type":"string","maxLength":64,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:archive:file:[0-9]+$","description":"Public id of a stored file: `{country}:archive:file:{n}`, e.g. `dk:archive:file:7`."}]}},{"name":"from_search","in":"query","required":false,"description":"The `search_id` of the search this result was opened from. Changes nothing in the answer.","schema":{"type":"string","pattern":"^s_[A-Za-z0-9_-]{22}$"}},{"name":"rank","in":"query","required":false,"description":"The result's position in that search, 1 for the first.","schema":{"type":"integer","minimum":1,"maximum":10000}},{"name":"file","in":"query","required":false,"description":"Which file of the document (default its main file).","schema":{"type":"string","maxLength":64,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:archive:file:[0-9]+$"}},{"name":"from_page","in":"query","required":false,"schema":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991}},{"name":"from_char","in":"query","required":false,"description":"Start this far into `from_page` (from `continue_from.char`).","schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},{"name":"to_page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":9007199254740991}},{"name":"max_chars","in":"query","required":false,"schema":{"default":20000,"type":"integer","minimum":500,"maximum":100000}},{"name":"include_summary","in":"query","required":false,"description":"Add the machine-written summary and its status.","schema":{"type":"string","enum":["true","false"]}},{"name":"include_attributes","in":"query","required":false,"description":"Add `item.attributes` (else only on the first read, from_page 1 and from_char 0).","schema":{"type":"string","enum":["true","false"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetDocumentPagesResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/documents/{id}/versions":{"get":{"operationId":"listDocumentVersions","summary":"A document's versions, newest first","tags":["core.changes"],"x-capability":"core.changes","x-replaces":["GET /v1/documents/{id}/versions"],"x-mcp-tools":["changes"],"x-reads":{"core":["document","publication","file"],"derived":["file_version","file_change"]},"parameters":[{"name":"id","in":"path","required":true,"description":"A document, publication or legal act id, a file id (`dk:archive:file:7`), or an agenda item's or speech's id (its own text, one page).","schema":{"anyOf":[{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$","description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is."},{"type":"string","maxLength":64,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:archive:file:[0-9]+$","description":"Public id of a stored file: `{country}:archive:file:{n}`, e.g. `dk:archive:file:7`."}]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListDocumentVersionsResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/matters":{"get":{"operationId":"listMatters","summary":"Matters by words in the title or by reference","description":"With `q`: every word in the title, short title or abstract (word forms of the instance language) or the reference; newest term first, within a term bills and resolutions first, then best match. Without `q`: latest updated first.","tags":["core.matters"],"x-capability":"core.matters","x-replaces":["GET /v1/cases"],"x-mcp-tools":[],"x-reads":{"core":["matter","term","body"],"indices":["matters"]},"x-coverage":true,"parameters":[{"name":"q","in":"query","required":false,"description":"Words in the title, short title or abstract, or a reference number.","schema":{"type":"string","minLength":1,"maxLength":500}},{"name":"reference","in":"query","required":false,"description":"Exact reference, e.g. `L 35` (spaces optional).","schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"term","in":"query","required":false,"description":"Term id, code (`20251`) or name (`2025-26`).","schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"body","in":"query","required":false,"description":"The body (default: every body).","schema":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$"}},{"name":"jurisdiction","in":"query","required":false,"description":"Jurisdictions: ids such as `dk:kommune-0101`, or exact names; `filters.jurisdictions_resolved` echoes the ids used.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":100,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"matter_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"matter_status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}},{"name":"format","in":"query","required":false,"description":"Answer with a file instead of JSON (at most 1 000 rows; larger lists: POST /v2/exports).","schema":{"type":"string","enum":["csv","xlsx"]}},{"name":"separator","in":"query","required":false,"description":"CSV field separator (default semicolon).","schema":{"type":"string","enum":["semicolon","comma"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListMattersResponse"}},"text/csv":{"schema":{"type":"string"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/matters/find":{"get":{"operationId":"findMatter","summary":"One matter by reference, with its whole course","description":"The newest matter with the reference (in `term` when given), answered like GET /v2/matters/{id}, plus `other_matches`.","tags":["core.matters"],"x-capability":"core.matters","x-replaces":["GET /v1/cases/find","GET /v1/decisions"],"x-mcp-tools":["get_matter"],"x-reads":{"core":["matter","matter_action","document","document_matter","vote_event","vote_count","speech","participation","relation","consultation","agenda_item","decision","term"],"derived":["summary","legislative_programme_match","bill_forecast"]},"x-coverage":true,"parameters":[{"name":"reference","in":"query","required":true,"description":"As people write it: `L 35`, `KOM (2022) 0209`, `Aktstk. 144`, `SUU alm. del`, a council's case number; a trailing term is read.","schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"term","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"body","in":"query","required":false,"description":"Default: the national parliament; a council's body for its case numbers.","schema":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$"}},{"name":"jurisdiction","in":"query","required":false,"description":"For council case numbers: which authorities.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":100,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"document_type","in":"query","required":false,"description":"Only these document types in `documents`.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}},{"name":"format","in":"query","required":false,"description":"Answer with a file instead of JSON (at most 1 000 rows; larger lists: POST /v2/exports).","schema":{"type":"string","enum":["csv","xlsx"]}},{"name":"separator","in":"query","required":false,"description":"CSV field separator (default semicolon).","schema":{"type":"string","enum":["semicolon","comma"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindMatterResponse"}},"text/csv":{"schema":{"type":"string"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/matters/{id}":{"get":{"operationId":"getMatter","summary":"One matter with its timeline, votes, debates, consultations, actors and documents","tags":["core.matters"],"x-capability":"core.matters","x-replaces":["GET /v1/cases/{id}"],"x-mcp-tools":["get_matter"],"x-reads":{"core":["matter","matter_action","document","document_matter","vote_event","vote_count","speech","participation","relation","consultation","agenda_item","decision","term"],"derived":["summary","legislative_programme_match","bill_forecast"]},"x-coverage":true,"parameters":[{"name":"id","in":"path","required":true,"description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is.","schema":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$"}},{"name":"document_type","in":"query","required":false,"description":"Only these document types in `documents`.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}},{"name":"from_search","in":"query","required":false,"description":"The `search_id` of the search this result was opened from. Changes nothing in the answer.","schema":{"type":"string","pattern":"^s_[A-Za-z0-9_-]{22}$"}},{"name":"rank","in":"query","required":false,"description":"The result's position in that search, 1 for the first.","schema":{"type":"integer","minimum":1,"maximum":10000}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetMatterResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/consultations":{"get":{"operationId":"listConsultations","summary":"Consultations by topic, authority, jurisdiction, status and deadline","description":"One list over the national consultation portal and the local authorities' own consultations. A consultation the source lists twice with the same documents appears once. An empty first page with `q` is retried once broader (`filters.q_broadened`).","tags":["core.consultations"],"x-capability":"core.consultations","x-replaces":["GET /v1/hearings"],"x-mcp-tools":["consultations"],"x-reads":{"core":["consultation","document","relation","matter","organization"],"indices":["consultations"]},"x-coverage":true,"parameters":[{"name":"q","in":"query","required":false,"description":"Words in the title, description and the opening text of the consultation documents (not the responses); short words (up to four characters) only as whole words; longer words also inside compounds.","schema":{"type":"string","minLength":1,"maxLength":500}},{"name":"authority","in":"query","required":false,"description":"Authority (publisher or organiser): an organization id, or (part of) its name; an exact name wins over names that only contain it.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"source","in":"query","required":false,"description":"One or more source slugs (repeated or comma-separated). Omit for every source the key may read.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"consultation_type","in":"query","required":false,"description":"Default `public`; `appeal-notice` for local decisions with an appeal deadline; `all` for every type.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":10,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"jurisdiction","in":"query","required":false,"description":"Only these local authorities' own consultations.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":100,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"status","in":"query","required":false,"description":"`open`: deadline today or later; `closed`: passed; `archived`: passed and archived by the source.","schema":{"type":"string","enum":["open","closed","archived"]}},{"name":"deadline_from","in":"query","required":false,"description":"A calendar day, `YYYY-MM-DD`, in the instance's time zone.","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"deadline_to","in":"query","required":false,"description":"A calendar day, `YYYY-MM-DD`, in the instance's time zone.","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"deadline_within_days","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":365}},{"name":"subject","in":"query","required":false,"description":"The source's subject area, by word start.","schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"sort","in":"query","required":false,"description":"Default: relevance with q, deadline with status=open or a deadline bound, else newest.","schema":{"type":"string","enum":["relevance","deadline","newest","responses"]}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}},{"name":"format","in":"query","required":false,"description":"Answer with a file instead of JSON (at most 1 000 rows; larger lists: POST /v2/exports).","schema":{"type":"string","enum":["csv","xlsx"]}},{"name":"separator","in":"query","required":false,"description":"CSV field separator (default semicolon).","schema":{"type":"string","enum":["semicolon","comma"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListConsultationsResponse"}},"text/csv":{"schema":{"type":"string"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/consultations/{id}":{"get":{"operationId":"getConsultation","summary":"One consultation with its documents, responses and what it changed","tags":["core.consultations"],"x-capability":"core.consultations","x-replaces":["GET /v1/hearings/{id}"],"x-mcp-tools":["consultations"],"x-reads":{"core":["consultation","consultation_response","document","relation","participation","organization","matter"]},"x-coverage":true,"parameters":[{"name":"id","in":"path","required":true,"description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is.","schema":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$"}},{"name":"from_search","in":"query","required":false,"description":"The `search_id` of the search this result was opened from. Changes nothing in the answer.","schema":{"type":"string","pattern":"^s_[A-Za-z0-9_-]{22}$"}},{"name":"rank","in":"query","required":false,"description":"The result's position in that search, 1 for the first.","schema":{"type":"integer","minimum":1,"maximum":10000}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetConsultationResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/meetings":{"get":{"operationId":"listMeetings","summary":"Meetings of a body, committee or authority by day","tags":["core.meetings"],"x-capability":"core.meetings","x-replaces":[],"x-mcp-tools":[],"x-reads":{"core":["meeting","organization","agenda_item"],"indices":["agenda-items"]},"x-coverage":true,"parameters":[{"name":"q","in":"query","required":false,"description":"Words in the meeting's title or its agenda items' titles.","schema":{"type":"string","minLength":1,"maxLength":500}},{"name":"body","in":"query","required":false,"description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is.","schema":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$"}},{"name":"committee","in":"query","required":false,"description":"A committee: organization id, or (part of) its name.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"jurisdiction","in":"query","required":false,"description":"Jurisdictions: ids such as `dk:kommune-0101`, or exact names; `filters.jurisdictions_resolved` echoes the ids used.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":100,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"source","in":"query","required":false,"description":"One or more source slugs (repeated or comma-separated). Omit for every source the key may read.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"meeting_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":10,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"from_date","in":"query","required":false,"description":"First day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"to_date","in":"query","required":false,"description":"Last day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"sort","in":"query","required":false,"schema":{"default":"newest","type":"string","enum":["newest","oldest"]}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}},{"name":"format","in":"query","required":false,"description":"Answer with a file instead of JSON (at most 1 000 rows; larger lists: POST /v2/exports).","schema":{"type":"string","enum":["csv","xlsx"]}},{"name":"separator","in":"query","required":false,"description":"CSV field separator (default semicolon).","schema":{"type":"string","enum":["semicolon","comma"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListMeetingsResponse"}},"text/csv":{"schema":{"type":"string"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/meetings/{id}":{"get":{"operationId":"getMeeting","summary":"One meeting with its documents and every agenda item","tags":["core.meetings"],"x-capability":"core.meetings","x-replaces":["GET /v1/agendas/{kilde}/{id}"],"x-mcp-tools":["local_decisions"],"x-reads":{"core":["meeting","document","agenda_item","decision","relation","organization"]},"x-coverage":true,"parameters":[{"name":"id","in":"path","required":true,"description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is.","schema":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetMeetingResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/agenda-items":{"get":{"operationId":"listAgendaItems","summary":"Local and regional agenda items and decisions by topic and authority","description":"Agenda items of councils and their committees; `message` names known coverage gaps of the chosen authorities, also when there are results.","tags":["core.meetings"],"x-capability":"core.meetings","x-replaces":["GET /v1/decisions"],"x-mcp-tools":["local_decisions"],"x-reads":{"core":["agenda_item","meeting","decision","document","relation","organization","area","jurisdiction"],"indices":["agenda-items"]},"x-coverage":true,"parameters":[{"name":"q","in":"query","required":false,"description":"Every word in the title or the text (search syntax).","schema":{"type":"string","minLength":1,"maxLength":500}},{"name":"jurisdiction","in":"query","required":false,"description":"Jurisdictions: ids such as `dk:kommune-0101`, or exact names; `filters.jurisdictions_resolved` echoes the ids used.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":100,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"largest","in":"query","required":false,"description":"Only the N authorities with the largest population (by the area's population).","schema":{"type":"integer","minimum":1,"maximum":500}},{"name":"source","in":"query","required":false,"description":"One or more source slugs (repeated or comma-separated). Omit for every source the key may read.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"committee","in":"query","required":false,"description":"A committee: organization id, or (part of) its name.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"reference","in":"query","required":false,"description":"The authority's case number.","schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"from_date","in":"query","required":false,"description":"First day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"to_date","in":"query","required":false,"description":"Last day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"decisions_only","in":"query","required":false,"description":"Only items with a decision read from minutes.","schema":{"type":"string","enum":["true","false"]}},{"name":"sort","in":"query","required":false,"description":"Default relevance with q, else newest.","schema":{"type":"string","enum":["relevance","newest"]}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":10,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}},{"name":"format","in":"query","required":false,"description":"Answer with a file instead of JSON (at most 1 000 rows; larger lists: POST /v2/exports).","schema":{"type":"string","enum":["csv","xlsx"]}},{"name":"separator","in":"query","required":false,"description":"CSV field separator (default semicolon).","schema":{"type":"string","enum":["semicolon","comma"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListAgendaItemsResponse"}},"text/csv":{"schema":{"type":"string"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/agenda-items/{id}":{"get":{"operationId":"getAgendaItem","summary":"One agenda item with its text, decision and annexes","tags":["core.meetings"],"x-capability":"core.meetings","x-replaces":[],"x-mcp-tools":["local_decisions"],"x-reads":{"core":["agenda_item","meeting","decision","document","relation","matter"]},"x-coverage":true,"parameters":[{"name":"id","in":"path","required":true,"description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is.","schema":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$"}},{"name":"from_search","in":"query","required":false,"description":"The `search_id` of the search this result was opened from. Changes nothing in the answer.","schema":{"type":"string","pattern":"^s_[A-Za-z0-9_-]{22}$"}},{"name":"rank","in":"query","required":false,"description":"The result's position in that search, 1 for the first.","schema":{"type":"integer","minimum":1,"maximum":10000}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAgendaItemResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/local-authorities/compare":{"get":{"operationId":"compareLocalAuthorities","summary":"Compare every local authority on one topic","description":"One row per authority of the level (default every municipality), also those without hits, telling treated, not_found (covered, nothing matches) and not_covered (agendas and minutes for the period not held). `view=timeline`: per month how many authorities took the topic up for the first time.","tags":["local.comparison"],"x-capability":"local.comparison","x-replaces":["GET /v1/decisions/compare"],"x-mcp-tools":["compare_local_authorities"],"x-reads":{"core":["agenda_item","meeting","decision","jurisdiction","area","organization"],"indices":["agenda-items"],"derived":["coverage_entity"]},"parameters":[{"name":"q","in":"query","required":true,"description":"The topic (search syntax); never broadened.","schema":{"type":"string","minLength":1,"maxLength":500}},{"name":"jurisdiction","in":"query","required":false,"description":"The authorities to compare (default: every authority of the level).","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":100,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"largest","in":"query","required":false,"description":"Only the N largest by population.","schema":{"type":"integer","minimum":1,"maximum":500}},{"name":"level","in":"query","required":false,"description":"Jurisdiction level (jurisdiction_level codes).","schema":{"default":"municipal","type":"string","enum":["municipal","regional","all"]}},{"name":"committee","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"from_date","in":"query","required":false,"description":"Default: five years before to_date (`filters.from_date_default`).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"to_date","in":"query","required":false,"description":"Last day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"decisions_only","in":"query","required":false,"description":"Only minutes items with a read decision.","schema":{"type":"string","enum":["true","false"]}},{"name":"items_per_authority","in":"query","required":false,"schema":{"default":3,"type":"integer","minimum":0,"maximum":3}},{"name":"view","in":"query","required":false,"schema":{"default":"table","type":"string","enum":["table","timeline"]}},{"name":"format","in":"query","required":false,"description":"Answer with a file instead of JSON (at most 1 000 rows; larger lists: POST /v2/exports).","schema":{"type":"string","enum":["csv","xlsx"]}},{"name":"separator","in":"query","required":false,"description":"CSV field separator (default semicolon).","schema":{"type":"string","enum":["semicolon","comma"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompareLocalAuthoritiesResponse"}},"text/csv":{"schema":{"type":"string"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/local-authorities/transparency":{"get":{"operationId":"localAuthorityTransparency","summary":"Local authorities' transparency figures for a period, ranked","description":"Per authority, computed daily from its agendas, minutes and consultations: share of closed items, items only as PDF, open items without decision text, median days from meeting to minutes, median consultation period, meetings. Rows with incomplete data are not ranked. Definitions come with the answer.","tags":["local.transparency"],"x-capability":"local.transparency","x-replaces":["GET /v1/municipalities/transparency"],"x-mcp-tools":["local_transparency"],"x-reads":{"core":["jurisdiction","area","organization"],"derived":["local_transparency"]},"parameters":[{"name":"jurisdiction","in":"query","required":false,"description":"Jurisdictions: ids such as `dk:kommune-0101`, or exact names; `filters.jurisdictions_resolved` echoes the ids used.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":100,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"period","in":"query","required":false,"description":"`12m` (rolling twelve months), a year (`2025`) or a quarter (`2025Q3`).","schema":{"default":"12m","type":"string","pattern":"^(12m|\\d{4}|\\d{4}Q[1-4])$"}},{"name":"sort","in":"query","required":false,"schema":{"default":"closed_items_share","type":"string","enum":["closed_items_share","pdf_only_share","without_decision_share","minutes_days","consultation_days","meetings"]}},{"name":"order","in":"query","required":false,"description":"Sort direction.","schema":{"default":"desc","type":"string","enum":["asc","desc"]}},{"name":"format","in":"query","required":false,"description":"Answer with a file instead of JSON (at most 1 000 rows; larger lists: POST /v2/exports).","schema":{"type":"string","enum":["csv","xlsx"]}},{"name":"separator","in":"query","required":false,"description":"CSV field separator (default semicolon).","schema":{"type":"string","enum":["semicolon","comma"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocalAuthorityTransparencyResponse"}},"text/csv":{"schema":{"type":"string"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/speeches":{"get":{"operationId":"listSpeeches","summary":"Speeches in the parliament's chamber, its committees and the councils, by topic, speaker, party, role, venue, matter and date","description":"One item per speech. The chair's lines only with `role=chair` or a `person`. `venue` says where it was given; committee and council speeches come from our transcripts of the meetings' videos (`transcript_kind` `machine`) with a link into the video. A `person` matches only speeches linked to that person. With `q`, `total`, `counts_per_party` and `counts_per_year` count every match (null past a 3 s budget). Transcripts withdrawn or removed at the source are left out.","tags":["parliament.statistics"],"x-capability":"parliament.statistics","x-replaces":["GET /v1/speeches"],"x-mcp-tools":["speeches"],"x-reads":{"core":["speech","meeting","agenda_item","matter","person","membership","organization","document"],"indices":["speeches"]},"parameters":[{"name":"q","in":"query","required":false,"description":"Topic: every word in the speech (search syntax, `speeches` index).","schema":{"type":"string","minLength":1,"maxLength":500}},{"name":"person","in":"query","required":false,"description":"A member of parliament or minister: a person id or (part of) a name, matched only among office holders; several matches answer `ambiguous_name` with `candidates`.","schema":{"type":"string","minLength":2,"maxLength":200}},{"name":"party","in":"query","required":false,"description":"A party: its organization id, short name as printed (`V`, `S`) or name; the party on the day (core.membership).","schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"role","in":"query","required":false,"description":"Speaker roles (`chair` only when asked, or with `person`).","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":9,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"matter","in":"query","required":false,"description":"Speeches on this matter.","schema":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$"}},{"name":"venue","in":"query","required":false,"description":"Where the speech was given: `chamber` (the parliament's plenary transcripts), `committee` (the parliament's committee meetings and hearings, from their video), `council` (municipal and regional councils, from their video). Default all.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":3,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"from_date","in":"query","required":false,"description":"First day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"to_date","in":"query","required":false,"description":"Last day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"sort","in":"query","required":false,"description":"Default `relevance` with `q`, else `newest`.","schema":{"type":"string","enum":["relevance","newest"]}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":10,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}},{"name":"format","in":"query","required":false,"description":"Answer with a file instead of JSON (at most 1 000 rows; larger lists: POST /v2/exports).","schema":{"type":"string","enum":["csv","xlsx"]}},{"name":"separator","in":"query","required":false,"description":"CSV field separator (default semicolon).","schema":{"type":"string","enum":["semicolon","comma"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpeechesResponse"}},"text/csv":{"schema":{"type":"string"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/votes":{"get":{"operationId":"listVotes","summary":"Votes: party cohesion, agreement between parties, dissenters, and the votes","description":"Computed per request over the vote events and votes: a member counts with the party they belonged to on the day. Absence never counts in cohesion and is never a dissent.","tags":["parliament.statistics"],"x-capability":"parliament.statistics","x-replaces":["GET /v1/statistics/votes"],"x-mcp-tools":["votes"],"x-reads":{"core":["vote_event","vote_count","vote","matter","membership","organization","person"],"indices":["matters"],"derived":["vote_party_line","vote_dissent"]},"parameters":[{"name":"view","in":"query","required":false,"description":"`cohesion`: per party, the share of cast votes that followed the party line; `agreement`: party pairs voting alike; `dissenters`: members by votes against their party; `votes`: the votes, newest first.","schema":{"default":"cohesion","type":"string","enum":["cohesion","agreement","dissenters","votes"]}},{"name":"party","in":"query","required":false,"description":"A party: its organization id, short name as printed (`V`, `S`) or name; the party on the day (core.membership).","schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"person","in":"query","required":false,"description":"A member of parliament or minister: a person id or (part of) a name, matched only among office holders; several matches answer `ambiguous_name` with `candidates`.","schema":{"type":"string","minLength":2,"maxLength":200}},{"name":"q","in":"query","required":false,"description":"Topic: the matters voted on (`matters` index), their title or subjects.","schema":{"type":"string","minLength":1,"maxLength":500}},{"name":"matter","in":"query","required":false,"description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is.","schema":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$"}},{"name":"from_date","in":"query","required":false,"description":"Default: 365 days before `to_date`.","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"to_date","in":"query","required":false,"description":"Last day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VotesResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/questions/response-times":{"get":{"operationId":"questionResponseTimes","summary":"How quickly ministers answer written questions","description":"Aggregates (median and p90 days, shares overdue, postponed, open past the deadline), up to 50 groups, and the questions newest first. The deadline is the instance's question rule, spelled out in `definitions`; the figures are computed by ingest after each sync.","tags":["parliament.statistics"],"x-capability":"parliament.statistics","x-replaces":["GET /v1/statistics/answers"],"x-mcp-tools":["question_response_times"],"x-reads":{"core":["matter","document","person","post","membership","organization"],"derived":["question_response_time"]},"parameters":[{"name":"minister","in":"query","required":false,"description":"A minister (office holders only, ADR 0018).","schema":{"type":"string","minLength":2,"maxLength":200}},{"name":"ministry","in":"query","required":false,"description":"A ministry or minister's post: organization or post id, or (part of) its name.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"committee","in":"query","required":false,"description":"Committee: organization id or name.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"asker","in":"query","required":false,"description":"The member who asked (office holders only).","schema":{"type":"string","minLength":2,"maxLength":200}},{"name":"party","in":"query","required":false,"description":"The asker's party on the day the question was asked.","schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"question_type","in":"query","required":false,"description":"Question kinds as matter_type codes: `question.written`, `question.committee` (with `matter_type=bill`: questions on a bill).","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":5,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"matter_type","in":"query","required":false,"description":"The type of the matter the question was asked under, e.g. `bill`.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":5,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"from_date","in":"query","required":false,"description":"Asked on or after; default 365 days before `to_date`.","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"to_date","in":"query","required":false,"description":"Last day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["open","overdue","answered"]}},{"name":"group_by","in":"query","required":false,"schema":{"type":"string","enum":["ministry","minister","month"]}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}},{"name":"format","in":"query","required":false,"description":"Answer with a file instead of JSON (at most 1 000 rows; larger lists: POST /v2/exports).","schema":{"type":"string","enum":["csv","xlsx"]}},{"name":"separator","in":"query","required":false,"description":"CSV field separator (default semicolon).","schema":{"type":"string","enum":["semicolon","comma"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionResponseTimesResponse"}},"text/csv":{"schema":{"type":"string"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/legislation":{"get":{"operationId":"listLegislation","summary":"Legal acts: acts, consolidated acts, regulations, circulars and guidance","description":"Search the legal gazette by title, act number and year, type, status, issuer and date, or list the acts issued under a law (`based_on`, any of its consolidations). Needs a key that may read the gazette's source. The municipalities' local land-use plans (act types `plan.local` and `plan.amendment`, source `plandata`) are legal acts too, but are left out by default: they are listed only when `act_type` names a plan type or `source` names `plandata`.","tags":["core.legislation"],"x-capability":"core.legislation","x-replaces":["GET /v1/legislation"],"x-mcp-tools":["legislation"],"x-reads":{"core":["legal_act","relation","organization","file"],"indices":["legal-acts"]},"parameters":[{"name":"q","in":"query","required":false,"description":"Title and popular title (`legal-acts` index); `NIS2` also finds `NIS 2`.","schema":{"type":"string","minLength":1,"maxLength":500}},{"name":"act_type","in":"query","required":false,"description":"Act types, e.g. `act`, `act.consolidated`, `regulation`. Local land-use plans (`plan.local`, `plan.amendment`; `plan` for both) are left out unless named here or `source` names `plandata`.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":10,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"source","in":"query","required":false,"description":"Only acts from these sources (e.g. `retsinformation`, `plandata`). Omit for every source the key may read; plans then stay out unless `act_type` names a plan type.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"act_status","in":"query","required":false,"schema":{"type":"string","enum":["in-force","repealed","not-yet-in-force","proposed","other"]}},{"name":"issuer","in":"query","required":false,"description":"The issuing authority (a ministry): organization id or (part of) its name.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"based_on","in":"query","required":false,"description":"The acts issued under this law: a legal act id or its ELI address; any consolidation of the law counts.","schema":{"type":"string","minLength":1,"maxLength":500}},{"name":"act_number","in":"query","required":false,"description":"The act's number in its series; with `year`.","schema":{"type":"integer","minimum":1,"maximum":9007199254740991}},{"name":"year","in":"query","required":false,"schema":{"type":"integer","minimum":1800,"maximum":2200}},{"name":"from_date","in":"query","required":false,"description":"First day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"to_date","in":"query","required":false,"description":"Last day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}},{"name":"format","in":"query","required":false,"description":"Answer with a file instead of JSON (at most 1 000 rows; larger lists: POST /v2/exports).","schema":{"type":"string","enum":["csv","xlsx"]}},{"name":"separator","in":"query","required":false,"description":"CSV field separator (default semicolon).","schema":{"type":"string","enum":["semicolon","comma"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegislationResponse"}},"text/csv":{"schema":{"type":"string"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/legislation/lifecycle":{"get":{"operationId":"legislationLifecycle","summary":"A law's life cycle across sources, as one timeline","description":"One anchor (matter, reference with term, act number with year, ELI, consultation or EU act) gives the timeline oldest first: the EU proposal and the government's memo, the consultation on the bill, the readings, the act, consolidations and amending acts, regulations issued under it and their consultations, the directives it transposes, and local agenda items that mention it. Walked in bounded hops over core.relation. Steps from sources the key may not read are counted in `omitted`.","tags":["core.legislation"],"x-capability":"core.legislation","x-replaces":["GET /v1/lifecycle"],"x-mcp-tools":["legislation_lifecycle"],"x-reads":{"core":["relation","matter","matter_action","legal_act","consultation","agenda_item","document"]},"parameters":[{"name":"matter","in":"query","required":false,"description":"A bill (matter id).","schema":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$"}},{"name":"reference","in":"query","required":false,"description":"A bill's reference (`L 35`), with `term`.","schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"term","in":"query","required":false,"description":"The term of `reference`: id, code or name.","schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"act_number","in":"query","required":false,"description":"A law's number, with `year`.","schema":{"type":"integer","minimum":1,"maximum":9007199254740991}},{"name":"year","in":"query","required":false,"schema":{"type":"integer","minimum":1800,"maximum":2200}},{"name":"eli","in":"query","required":false,"schema":{"type":"string","maxLength":2048,"format":"uri"}},{"name":"consultation","in":"query","required":false,"description":"A consultation on the bill or an executive order.","schema":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$"}},{"name":"eu_act","in":"query","required":false,"description":"An EU proposal or act: CELEX number or COM reference (`COM(2022) 209`).","schema":{"type":"string","minLength":1,"maxLength":100}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LifecycleResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/eu/transposition":{"get":{"operationId":"euTransposition","summary":"EU directives and their transposition into national law","description":"The directives national acts or bills name, with the acts that transpose them, the bills, the COM proposal and the deadline when known (`deadline_missing` otherwise).","tags":["eu.transposition"],"x-capability":"eu.transposition","x-replaces":["GET /v1/eu-implementation"],"x-mcp-tools":["legislation_lifecycle"],"x-reads":{"core":["legal_act","relation","matter"],"indices":["legal-acts"]},"parameters":[{"name":"transposition_status","in":"query","required":false,"description":"`not_found`: no national transposition found, not that the country is late.","schema":{"type":"string","enum":["transposed","not_found"]}},{"name":"eu_act","in":"query","required":false,"description":"A directive: CELEX number or legal act id.","schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"q","in":"query","required":false,"description":"Search text in the search syntax: plain words are all required (word forms of the instance language), \"exact phrase\", wildcards `skat*`/`kommun?`, `skat~` (fuzzy), `OR`, `-word` to exclude.","schema":{"type":"string","minLength":1,"maxLength":500}},{"name":"deadline_from","in":"query","required":false,"description":"A calendar day, `YYYY-MM-DD`, in the instance's time zone.","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"deadline_to","in":"query","required":false,"description":"A calendar day, `YYYY-MM-DD`, in the instance's time zone.","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EuTranspositionResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/government/legislative-programme":{"get":{"operationId":"legislativeProgramme","summary":"The government's legislative programme held against the parliament's matters","description":"One item per programme item in the programme's order, then the session's government bills that were not in the programme (`in_programme: false`). Status from the matched matter's live status; forecasts for open bills.","tags":["government.legislative-programme"],"x-capability":"government.legislative-programme","x-replaces":["GET /v1/legislative-programme"],"x-mcp-tools":["legislative_programme"],"x-reads":{"core":["document","relation","matter","matter_action","term"],"derived":["bill_forecast"]},"parameters":[{"name":"term","in":"query","required":false,"description":"The session: id, code or name; default the newest programme.","schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"ministry","in":"query","required":false,"description":"Ministry or minister: (part of) the name.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["not_introduced","introduced","passed","rejected","lapsed","not_in_programme"]}},{"name":"delayed","in":"query","required":false,"schema":{"type":"string","enum":["true","false"]}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–200).","schema":{"default":50,"type":"integer","minimum":1,"maximum":200}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}},{"name":"format","in":"query","required":false,"description":"Answer with a file instead of JSON (at most 1 000 rows; larger lists: POST /v2/exports).","schema":{"type":"string","enum":["csv","xlsx"]}},{"name":"separator","in":"query","required":false,"description":"CSV field separator (default semicolon).","schema":{"type":"string","enum":["semicolon","comma"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegislativeProgrammeResponse"}},"text/csv":{"schema":{"type":"string"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/procurement":{"get":{"operationId":"listProcurement","summary":"Procurement notices by CPV code, value, deadline, buyer, notice type and date","description":"The notices of public procurement portals (above the EU thresholds from TED, the national ones from the national portal), one item per notice; a notice both publish appears once. Values are compared in their own currency; give `currency` to compare like with like.","tags":["procurement"],"x-capability":"procurement","x-replaces":[],"x-mcp-tools":["procurement"],"x-reads":{"core":["procurement_notice","vocabulary"]},"x-coverage":true,"parameters":[{"name":"q","in":"query","required":false,"description":"Words in the title or the description (every word, as a substring).","schema":{"type":"string","minLength":1,"maxLength":500}},{"name":"cpv","in":"query","required":false,"description":"CPV codes or their beginnings, 2–8 digits; trailing zeros are dropped, so `45000000` and `45` both mean every construction code. A notice matches when any of its codes does.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"buyer","in":"query","required":false,"description":"A buyer: an organization id, a national registry number (a Danish CVR number, 8 digits), or (part of) its name.","schema":{"type":"string","minLength":2,"maxLength":200}},{"name":"notice_type","in":"query","required":false,"description":"Only these kinds of notice (default every kind).","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":10,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"procedure","in":"query","required":false,"description":"Only the notices of this procedure (a matter id).","schema":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$"}},{"name":"value_from","in":"query","required":false,"description":"Value at least this (in `currency` when given).","schema":{"type":"number","minimum":0,"maximum":1000000000000000}},{"name":"value_to","in":"query","required":false,"description":"Value at most this (in `currency` when given).","schema":{"type":"number","minimum":0,"maximum":1000000000000000}},{"name":"value_kind","in":"query","required":false,"description":"Which value the bounds and `sort=value` read: `awarded`, `estimated`, or `any` (default: the awarded value where there is one, else the estimate).","schema":{"type":"string","enum":["any","estimated","awarded"]}},{"name":"currency","in":"query","required":false,"description":"ISO 4217 code: only values in this currency (values are never converted).","schema":{"type":"string","pattern":"^[A-Z]{3}$"}},{"name":"deadline_from","in":"query","required":false,"description":"Tender deadline on or after this day.","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"deadline_to","in":"query","required":false,"description":"Tender deadline on or before this day.","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"from_date","in":"query","required":false,"description":"Published on or after this day.","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"to_date","in":"query","required":false,"description":"Published on or before this day.","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"source","in":"query","required":false,"description":"One or more source slugs (repeated or comma-separated). Omit for every source the key may read.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"sort","in":"query","required":false,"description":"`newest` (default): published newest first; `deadline`: coming deadlines soonest first; `value`: largest first.","schema":{"type":"string","enum":["newest","deadline","value"]}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}},{"name":"format","in":"query","required":false,"description":"Answer with a file instead of JSON (at most 1 000 rows; larger lists: POST /v2/exports).","schema":{"type":"string","enum":["csv","xlsx"]}},{"name":"separator","in":"query","required":false,"description":"CSV field separator (default semicolon).","schema":{"type":"string","enum":["semicolon","comma"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListProcurementResponse"}},"text/csv":{"schema":{"type":"string"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/procurement/{id}":{"get":{"operationId":"getProcurementNotice","summary":"One procurement notice with the other notices of its procedure","tags":["procurement"],"x-capability":"procurement","x-replaces":[],"x-mcp-tools":["procurement"],"x-reads":{"core":["procurement_notice","vocabulary"]},"x-coverage":true,"parameters":[{"name":"id","in":"path","required":true,"description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is.","schema":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetProcurementNoticeResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/rulings":{"get":{"operationId":"listRulings","summary":"Rulings of appeal boards, the Ombudsman and private ankenævn, with an outcome facet","description":"One item per published decision, filtered by board, kind, outcome, type, subject area, party, reference, legal basis and dates. `outcomes` counts the matches per outcome. The outcome is Rigsdata's classification of the board's own words; cite `source_url`.","tags":["rulings"],"x-capability":"rulings","x-replaces":[],"x-mcp-tools":["rulings"],"x-reads":{"core":["ruling","organization","vocabulary"]},"x-coverage":true,"parameters":[{"name":"issuer","in":"query","required":false,"description":"Boards: a board's slug (`planklagenaevnet`, see `/v2/rulings/issuers`) or an organization id.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"issuer_kind","in":"query","required":false,"description":"`state` boards, `private` (approved) ankenævn, the `ombudsman`.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":3,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"q","in":"query","required":false,"description":"Words in the title or the summary (every word, as a substring).","schema":{"type":"string","minLength":1,"maxLength":500}},{"name":"outcome","in":"query","required":false,"description":"Only these outcomes (Rigsdata's classification, from the complainant's side).","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":7,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"ruling_type","in":"query","required":false,"description":"Only these kinds of ruling.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":8,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"subject_area","in":"query","required":false,"description":"A subject area as the board names it (part of the name, any case).","schema":{"type":"string","minLength":2,"maxLength":200}},{"name":"party","in":"query","required":false,"description":"A party that is a company or an authority: a CVR number (8 digits) or its name.","schema":{"type":"string","minLength":2,"maxLength":200}},{"name":"reference","in":"query","required":false,"description":"A journal or case number, exactly as the board writes it.","schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"legal_basis","in":"query","required":false,"description":"A law or rule the ruling cites (part of its name, any case).","schema":{"type":"string","minLength":2,"maxLength":200}},{"name":"decided_from","in":"query","required":false,"description":"Decided on or after this day; a ruling without a decision day counts its publication day.","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"decided_to","in":"query","required":false,"description":"Decided on or before this day (same fallback).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"published_from","in":"query","required":false,"description":"Published on or after this day.","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"published_to","in":"query","required":false,"description":"Published on or before this day.","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"principle","in":"query","required":false,"description":"`true`: only rulings the board marks as principled.","schema":{"type":"string","enum":["true","false"]}},{"name":"sort","in":"query","required":false,"description":"`decided` (default): newest decision first, the publication day where a board gives no decision day; `published`: newest publication first.","schema":{"type":"string","enum":["decided","published"]}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}},{"name":"format","in":"query","required":false,"description":"Answer with a file instead of JSON (at most 1 000 rows; larger lists: POST /v2/exports).","schema":{"type":"string","enum":["csv","xlsx"]}},{"name":"separator","in":"query","required":false,"description":"CSV field separator (default semicolon).","schema":{"type":"string","enum":["semicolon","comma"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListRulingsResponse"}},"text/csv":{"schema":{"type":"string"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/rulings/issuers":{"get":{"operationId":"listRulingIssuers","summary":"The boards: whether they are read, how many rulings, first and last decision","tags":["rulings"],"x-capability":"rulings","x-replaces":[],"x-mcp-tools":["rulings"],"x-reads":{"core":["organization","ruling"]},"x-coverage":true,"parameters":[{"name":"issuer_kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":3,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"read","in":"query","required":false,"description":"`true`: only boards Rigsdata reads; `false`: only the rest.","schema":{"type":"string","enum":["true","false"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListRulingIssuersResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/rulings/{id}":{"get":{"operationId":"getRuling","summary":"One ruling","tags":["rulings"],"x-capability":"rulings","x-replaces":[],"x-mcp-tools":["rulings"],"x-reads":{"core":["ruling","organization","vocabulary"]},"x-coverage":true,"parameters":[{"name":"id","in":"path","required":true,"description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is.","schema":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetRulingResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/stakeholders":{"get":{"operationId":"listStakeholders","summary":"Organisations that respond to consultations, with counts","description":"Organisations only. The counts are the instance's compilation of published consultation responses; the sender is read from the response's title, file name or text. With `authority`, `subject` or a date the counts are those within the filter.","tags":["consultation.stakeholders"],"x-capability":"consultation.stakeholders","x-replaces":["GET /v1/stakeholders"],"x-mcp-tools":["consultation_stakeholders"],"x-reads":{"core":["organization","consultation_response","consultation","participation","relation"],"derived":["stakeholder_stats"]},"x-coverage":true,"parameters":[{"name":"name","in":"query","required":false,"description":"An organisation's name, abbreviation or part of it. Never a person's name.","schema":{"type":"string","minLength":2,"maxLength":200}},{"name":"respondent_category","in":"query","required":false,"schema":{"type":"string","enum":["company","business-association","ngo","interest-group","trade-union","public-authority","academic","citizen","other"]}},{"name":"authority","in":"query","required":false,"description":"Only responses to consultations of this organiser.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"subject","in":"query","required":false,"description":"Only consultations on this subject area.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"from_date","in":"query","required":false,"description":"First day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"to_date","in":"query","required":false,"description":"Last day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"sort","in":"query","required":false,"description":"`changes`: by consultations where a memo ties the organisation to a change.","schema":{"default":"responses","type":"string","enum":["responses","name","latest","changes"]}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}},{"name":"format","in":"query","required":false,"description":"Answer with a file instead of JSON (at most 1 000 rows; larger lists: POST /v2/exports).","schema":{"type":"string","enum":["csv","xlsx"]}},{"name":"separator","in":"query","required":false,"description":"CSV field separator (default semicolon).","schema":{"type":"string","enum":["semicolon","comma"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StakeholdersResponse"}},"text/csv":{"schema":{"type":"string"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/stakeholders/{id}":{"get":{"operationId":"getStakeholder","summary":"One stakeholder's profile: responses, distribution, positions, who it responds with, influence","tags":["consultation.stakeholders"],"x-capability":"consultation.stakeholders","x-replaces":["GET /v1/stakeholders/{id}"],"x-mcp-tools":["consultation_stakeholders"],"x-reads":{"core":["organization","consultation_response","consultation","document","participation","relation"],"derived":["stakeholder_stats","stakeholder_influence"]},"x-coverage":true,"parameters":[{"name":"id","in":"path","required":true,"description":"The stakeholder (organization id).","schema":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$"}},{"name":"limit","in":"query","required":false,"description":"Latest responses per page.","schema":{"default":10,"type":"integer","minimum":1,"maximum":50}},{"name":"cursor","in":"query","required":false,"description":"Next page of `latest_responses` (the page has the profile and those only).","schema":{"type":"string","maxLength":1024}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StakeholderProfileResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/changes":{"get":{"operationId":"listChanges","summary":"Changes: new editions, changed fields and removed documents, newest first","description":"Each item is the document with its `change`. Keyset on (time, id); every filter is a column of the change history. A restricted key reads its own sources (403 for another source, 404 for another source's change or document).","tags":["core.changes"],"x-capability":"core.changes","x-replaces":["GET /v1/changes"],"x-mcp-tools":["changes"],"x-reads":{"core":["file","document","matter","consultation","relation"],"derived":["file_change"]},"x-coverage":true,"parameters":[{"name":"source","in":"query","required":false,"description":"One or more source slugs (repeated or comma-separated). Omit for every source the key may read.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"change_kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":4,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"authority","in":"query","required":false,"description":"Authority (publisher or organiser): an organization id, or (part of) its name; an exact name wins over names that only contain it.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"document_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"from_date","in":"query","required":false,"description":"On the change time (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"to_date","in":"query","required":false,"description":"Last day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"document","in":"query","required":false,"description":"Changes of one document; new editions with the same text only then.","schema":{"anyOf":[{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$","description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is."},{"type":"string","maxLength":64,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:archive:file:[0-9]+$","description":"Public id of a stored file: `{country}:archive:file:{n}`, e.g. `dk:archive:file:7`."}]},"style":"form","explode":true},{"name":"matter","in":"query","required":false,"description":"A matter's own record, its documents' records and files.","schema":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$"}},{"name":"consultation","in":"query","required":false,"description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is.","schema":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$"}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}},{"name":"format","in":"query","required":false,"description":"Answer with a file instead of JSON (at most 1 000 rows; larger lists: POST /v2/exports).","schema":{"type":"string","enum":["csv","xlsx"]}},{"name":"separator","in":"query","required":false,"description":"CSV field separator (default semicolon).","schema":{"type":"string","enum":["semicolon","comma"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangesResponse"}},"text/csv":{"schema":{"type":"string"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/changes/{id}":{"get":{"operationId":"getChange","summary":"One change with its line-by-line difference","tags":["core.changes"],"x-capability":"core.changes","x-replaces":["GET /v1/changes/{id}"],"x-mcp-tools":["changes"],"x-reads":{"core":["file","page","document"],"derived":["file_change","file_version"]},"parameters":[{"name":"id","in":"path","required":true,"description":"Public id of a recorded change: `{country}:archive:change:{n}`.","schema":{"type":"string","maxLength":64,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:archive:change:[0-9]+$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeDetailResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/reuse":{"get":{"operationId":"textReuse","summary":"Text reuse: passages a document shares with other documents","description":"Each item is the other document, with `page` and `excerpt` at the passage and `reuse`. Precomputed for selected document types (bills, committee reports, answers, consultation documents, press releases, news, newsletters, agendas and minutes).","tags":["text-reuse"],"x-capability":"text-reuse","x-replaces":["GET /v1/reuse"],"x-mcp-tools":["text_reuse"],"x-reads":{"core":["file","page","document","consultation_response","organization"],"derived":["reuse_fingerprint","reuse_match"]},"parameters":[{"name":"document","in":"query","required":false,"description":"The document whose passages are looked for elsewhere (one of `document`, `text`).","schema":{"anyOf":[{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$","description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is."},{"type":"string","maxLength":64,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:archive:file:[0-9]+$","description":"Public id of a stored file: `{country}:archive:file:{n}`, e.g. `dk:archive:file:7`."}]},"style":"form","explode":true},{"name":"text","in":"query","required":false,"description":"A pasted passage, at least 20 words, at most 2 000 characters.","schema":{"type":"string","minLength":20,"maxLength":2000}},{"name":"source","in":"query","required":false,"description":"Sources of the other documents.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"authority","in":"query","required":false,"description":"Authority (publisher or organiser): an organization id, or (part of) its name; an exact name wins over names that only contain it.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"direction","in":"query","required":false,"description":"`earlier`: other documents that came first (where the text comes from); `later`: reuse after it.","schema":{"default":"both","type":"string","enum":["earlier","later","both"]}},{"name":"from_date","in":"query","required":false,"description":"First day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"to_date","in":"query","required":false,"description":"Last day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"include_copies","in":"query","required":false,"description":"Also versions of the same document.","schema":{"type":"string","enum":["true","false"]}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TextReuseResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/trends":{"get":{"operationId":"listTrends","summary":"Terms rising across the sources","description":"Terms in markedly more documents than usual. A term in more than 10 % of a source's documents is boilerplate and left out. A restricted key sees counts from its sources only. Computed nightly.","tags":["trends"],"x-capability":"trends","x-replaces":["GET /v1/trends"],"x-mcp-tools":["trends"],"x-reads":{"core":["document","publication","agenda_item"],"derived":["term_frequency","trend"]},"parameters":[{"name":"period","in":"query","required":false,"description":"`week`: the latest full week; `month`: four weeks; each against the 12 weeks before.","schema":{"default":"week","type":"string","enum":["week","month"]}},{"name":"source","in":"query","required":false,"description":"One or more source slugs (repeated or comma-separated). Omit for every source the key may read.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"authority","in":"query","required":false,"description":"Authority (publisher or organiser): an organization id, or (part of) its name; an exact name wins over names that only contain it.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"jurisdiction","in":"query","required":false,"description":"Jurisdictions: ids such as `dk:kommune-0101`, or exact names; `filters.jurisdictions_resolved` echoes the ids used.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":100,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"q","in":"query","required":false,"description":"Only terms of documents matching this topic.","schema":{"type":"string","minLength":1,"maxLength":500}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"min_breadth","in":"query","required":false,"description":"At least this many authorities.","schema":{"type":"integer","minimum":1,"maximum":9007199254740991}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendsResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/trends/term":{"get":{"operationId":"trendTerm","summary":"One term's course over time, per week or month, by source and authority","tags":["trends"],"x-capability":"trends","x-replaces":["GET /v1/trends/term"],"x-mcp-tools":["trends"],"x-reads":{"core":[],"derived":["term_frequency"]},"parameters":[{"name":"term","in":"query","required":true,"description":"The word or expression.","schema":{"type":"string","minLength":2,"maxLength":100}},{"name":"from_date","in":"query","required":false,"description":"First day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"to_date","in":"query","required":false,"description":"Last day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"group_by","in":"query","required":false,"schema":{"default":"month","type":"string","enum":["week","month"]}},{"name":"source","in":"query","required":false,"description":"One or more source slugs (repeated or comma-separated). Omit for every source the key may read.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendTermResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/coverage":{"get":{"operationId":"getCoverage","summary":"Coverage: what each source covers, how fresh it is, and known gaps","description":"Per source plugin: searchable documents and records, earliest and latest date, last fetch and sync and whether that is within the manifest's promise, the text backlog, the units (municipalities, regions, ministries, parties) covered fully, partly or not, and the known gaps. Compact by default. No operator notes, error texts or host names.","tags":["core.coverage"],"x-capability":"core.coverage","x-replaces":["GET /v1/coverage"],"x-mcp-tools":["coverage"],"x-reads":{"core":["jurisdiction","organization"],"derived":["coverage_source","coverage_entity","coverage_reconciliation","sync_state"]},"parameters":[{"name":"source","in":"query","required":false,"description":"Only this source.","schema":{"type":"string","maxLength":50,"pattern":"^[a-z0-9][a-z0-9_-]*$"}},{"name":"details","in":"query","required":false,"description":"Also sync details, the reconciliation against the source and the unit list.","schema":{"type":"string","enum":["true","false"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoverageResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/attestations/{id}":{"get":{"operationId":"getAttestation","summary":"The coverage attestation of an earlier answer","description":"What was asked (operation and parameters, as in the organisation's audit log), when, how many results and the first result ids, and the coverage as it was. Only for the organisation's own keys and tokens; kept 12 months. An id from the last 30 s may answer `404 attestation_not_ready` with `Retry-After`.","tags":["core.attestations"],"x-capability":"core.attestations","x-replaces":["GET /v1/attest/{id}"],"x-mcp-tools":[],"x-reads":{"core":[],"app":["audit_event"],"derived":["coverage_snapshot"]},"parameters":[{"name":"id","in":"path","required":true,"description":"`coverage.attestation_id`, or the `X-Rigsdata-Attest` header.","schema":{"type":"string","pattern":"^[0-9A-Za-z]{22}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttestationResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/deadlines":{"get":{"operationId":"listDeadlines","summary":"Upcoming deadlines and meetings from every source, in start order","description":"Consultation and appeal deadlines, answer and committee deadlines, readings, consultation meetings, plenary, committee and council meetings. Default today and 30 days ahead; at most 400 days at a time. A deadline is a day (`all_day`), a meeting an instant. The same filters as a calendar.","tags":["core.calendars"],"x-capability":"core.calendars","x-replaces":["GET /v1/deadlines"],"x-mcp-tools":["deadlines"],"x-reads":{"core":["consultation","matter_action","meeting","agenda_item","organization"],"indices":["consultations","matters","agenda-items"]},"parameters":[{"name":"event_types","in":"query","required":false,"description":"Only these kinds of event; omit for every deadline and meeting.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":9,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"q","in":"query","required":false,"description":"Only events about these words (the search syntax, stored as one term).","schema":{"type":"string","minLength":1,"maxLength":500}},{"name":"jurisdiction","in":"query","required":false,"description":"Jurisdictions: ids such as `dk:kommune-0101`, or exact names; `filters.jurisdictions_resolved` echoes the ids used.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":100,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"authority","in":"query","required":false,"description":"Authority (publisher or organiser): an organization id, or (part of) its name; an exact name wins over names that only contain it.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"matters","in":"query","required":false,"description":"Only these matters' deadlines, readings and meetings.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":50,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"consultations","in":"query","required":false,"description":"Only these consultations' deadlines.","schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":50,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"days","in":"query","required":false,"description":"From today and this many days ahead (default 30).","schema":{"type":"integer","minimum":1,"maximum":366}},{"name":"from_date","in":"query","required":false,"description":"First day (default today).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"to_date","in":"query","required":false,"description":"Last day included (instance time zone).","schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}},{"name":"format","in":"query","required":false,"description":"Answer with a file instead of JSON (at most 1 000 rows; larger lists: POST /v2/exports).","schema":{"type":"string","enum":["csv","xlsx"]}},{"name":"separator","in":"query","required":false,"description":"CSV field separator (default semicolon).","schema":{"type":"string","enum":["semicolon","comma"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeadlinesResponse"}},"text/csv":{"schema":{"type":"string"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/calendars":{"get":{"operationId":"listCalendars","summary":"The organisation's deadline calendars (a user sees their own)","description":"The address is never shown here, only when created.","tags":["core.calendars"],"x-capability":"core.calendars","x-replaces":["GET /v1/calendars"],"x-mcp-tools":["deadlines"],"x-reads":{"core":[],"app":["calendar_feed"]},"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarListResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createCalendar","summary":"Create a deadline calendar (an ICS subscription)","description":"The calendar is an address (/cal/{token}.ics) Outlook, Google and Apple calendars subscribe to: 30 days back, 365 ahead. The address is in the answer once. The plan limits calendars. With `preview=true` nothing is created.","tags":["core.calendars"],"x-capability":"core.calendars","x-replaces":["POST /v1/calendars"],"x-mcp-tools":["deadlines"],"x-reads":{"core":[],"app":["calendar_feed","plans"]},"x-oauth-scope":"rigsdata:write","parameters":[{"name":"preview","in":"query","required":false,"description":"true: every check of a create, nothing created.","schema":{"type":"string","enum":["true","false"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"event_types":{"maxItems":9,"type":"array","items":{"type":"string","enum":["consultation_deadline","appeal_deadline","answer_deadline","committee_deadline","reading","consultation_meeting","plenary_meeting","committee_meeting","council_meeting"]}},"source":{"maxItems":20,"type":"array","items":{"type":"string","maxLength":50,"pattern":"^[a-z0-9][a-z0-9_-]*$","description":"Slug of a source plugin, as listed by GET /v2/coverage (e.g. `folketing`, `hoeringsportalen`, `kommuner`). The set depends on the instance."}},"terms":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"term":{"type":"string","minLength":1,"maxLength":200},"match":{"default":"word","description":"`word`: the word in every inflection (several words must all occur); `starts_with`, `ends_with`, `contains`: patterns on the word as written (at least 2 letters); `phrase`: the words in sequence; `advanced`: the search syntax as typed.","type":"string","enum":["word","starts_with","ends_with","contains","phrase","advanced"]},"exclude":{"default":false,"description":"True: 'but not'.","type":"boolean"}},"required":["term"],"additionalProperties":false}},"all_terms":{"type":"boolean"},"query":{"type":"string","minLength":1,"maxLength":200},"jurisdiction":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":100,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?(?::[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)?$","description":"Jurisdiction id: the country (`dk`), a subdivision (`de-by`) or a local authority's namespace (`dk:kommune-0101`)."}},"authority":{"maxItems":50,"type":"array","items":{"type":"string","minLength":2,"maxLength":200}},"matters":{"maxItems":50,"type":"array","items":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$","description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is."}},"consultations":{"maxItems":50,"type":"array","items":{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$","description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is."}}},"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarPreviewResponse"}}}},"201":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarCreatedResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/calendars/{id}":{"delete":{"operationId":"revokeCalendar","summary":"Revoke a calendar: its address stops working","tags":["core.calendars"],"x-capability":"core.calendars","x-replaces":["DELETE /v1/calendars/{id}"],"x-mcp-tools":["deadlines"],"x-reads":{"core":[],"app":["calendar_feed"]},"x-oauth-scope":"rigsdata:write","parameters":[{"name":"id","in":"path","required":true,"description":"Id of an object in the organisation's account (a uuid).","schema":{"type":"string","pattern":"^[0-9a-f-]{8,64}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarRevokedResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/cal/{token}.ics":{"get":{"operationId":"calendarFeed","summary":"The ICS feed of a calendar, for calendar apps","description":"Public: the token in the path is the credential (unknown, malformed and revoked: 404). RFC 5545 with the instance zone's VTIMEZONE; deadlines are all-day events, meetings carry their wall clock. ETag/304. Not metered, not audited.","tags":["core.calendars"],"x-capability":"core.calendars","x-replaces":["GET /cal/{token}.ics"],"x-mcp-tools":[],"x-reads":{"core":["consultation","matter_action","meeting"],"app":["calendar_feed"]},"security":[],"parameters":[{"name":"token","in":"path","required":true,"description":"The feed's secret token.","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{20,128}$"}}],"responses":{"200":{"description":"The calendar (ICS).","content":{"text/calendar":{"schema":{"type":"string"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/dossiers":{"get":{"operationId":"listDossiers","summary":"The organisation's dossiers","description":"Shared by the whole organisation. A source-restricted key sees only its sources' items.","tags":["core.dossiers"],"x-capability":"core.dossiers","x-replaces":["GET /v1/dossiers"],"x-mcp-tools":["dossier"],"x-reads":{"core":[],"app":["dossier","dossier_item","dossier_note","dossier_read"]},"x-oauth-scope":"rigsdata:write","parameters":[{"name":"archived","in":"query","required":false,"description":"true: archived dossiers instead of active ones.","schema":{"type":"string","enum":["true","false"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DossierListResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createDossier","summary":"Create a dossier, optionally with items","description":"Items are ids from other answers; matters, consultations and agenda items are followed. The plan limits active dossiers. With `preview=true` nothing is created.","tags":["core.dossiers"],"x-capability":"core.dossiers","x-replaces":["POST /v1/dossiers"],"x-mcp-tools":["dossier"],"x-reads":{"core":["matter","consultation","agenda_item","document","publication","file"],"app":["dossier","dossier_item","dossier_note","dossier_read"]},"x-oauth-scope":"rigsdata:write","parameters":[{"name":"preview","in":"query","required":false,"description":"true: every check of a create, nothing created.","schema":{"type":"string","enum":["true","false"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":2000},"items":{"description":"Ids from other answers to add and follow.","maxItems":50,"type":"array","items":{"anyOf":[{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$","description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is."},{"type":"string","maxLength":64,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:archive:file:[0-9]+$","description":"Public id of a stored file: `{country}:archive:file:{n}`, e.g. `dk:archive:file:7`."}]}}},"required":["title"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DossierPreviewResponse"}}}},"201":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DossierResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/dossiers/{id}":{"get":{"operationId":"getDossier","summary":"One dossier with status, notes and the newest items","tags":["core.dossiers"],"x-capability":"core.dossiers","x-replaces":["GET /v1/dossiers/{id}"],"x-mcp-tools":["dossier"],"x-reads":{"core":["matter","consultation","agenda_item","document"],"derived":["summary"],"app":["dossier","dossier_item","dossier_note","dossier_read"]},"x-oauth-scope":"rigsdata:write","parameters":[{"name":"id","in":"path","required":true,"description":"Id of an object in the organisation's account (a uuid).","schema":{"type":"string","pattern":"^[0-9a-f-]{8,64}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DossierDetailResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"updateDossier","summary":"Rename, describe, archive or reopen a dossier","tags":["core.dossiers"],"x-capability":"core.dossiers","x-replaces":["PATCH /v1/dossiers/{id}"],"x-mcp-tools":[],"x-reads":{"core":[],"app":["dossier","dossier_item","dossier_note","dossier_read"]},"x-oauth-scope":"rigsdata:write","parameters":[{"name":"id","in":"path","required":true,"description":"Id of an object in the organisation's account (a uuid).","schema":{"type":"string","pattern":"^[0-9a-f-]{8,64}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":2000},"archived":{"description":"true archives, false reopens (counts again).","type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DossierResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"deleteDossier","summary":"Delete a dossier with its items and notes","tags":["core.dossiers"],"x-capability":"core.dossiers","x-replaces":["DELETE /v1/dossiers/{id}"],"x-mcp-tools":[],"x-reads":{"core":[],"app":["dossier","dossier_item","dossier_note","dossier_read"]},"x-oauth-scope":"rigsdata:write","parameters":[{"name":"id","in":"path","required":true,"description":"Id of an object in the organisation's account (a uuid).","schema":{"type":"string","pattern":"^[0-9a-f-]{8,64}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Deleted"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/dossiers/{id}/items":{"get":{"operationId":"listDossierItems","summary":"A dossier's items, newest first","tags":["core.dossiers"],"x-capability":"core.dossiers","x-replaces":["GET /v1/dossiers/{id}/items"],"x-mcp-tools":["dossier"],"x-reads":{"core":[],"derived":["summary"],"app":["dossier","dossier_item","dossier_note","dossier_read"]},"x-oauth-scope":"rigsdata:write","parameters":[{"name":"id","in":"path","required":true,"description":"Id of an object in the organisation's account (a uuid).","schema":{"type":"string","pattern":"^[0-9a-f-]{8,64}$"}},{"name":"entity_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":4000},{"maxItems":10,"type":"array","items":{"type":"string","maxLength":500}}]},"style":"form","explode":true},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DossierItemsResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"addDossierItem","summary":"Add a matter, consultation, agenda item or document to a dossier","tags":["core.dossiers"],"x-capability":"core.dossiers","x-replaces":["POST /v1/dossiers/{id}/items"],"x-mcp-tools":["dossier"],"x-reads":{"core":["matter","consultation","agenda_item","document","publication","file"],"app":["dossier","dossier_item","dossier_note","dossier_read"]},"x-oauth-scope":"rigsdata:write","parameters":[{"name":"id","in":"path","required":true,"description":"Id of an object in the organisation's account (a uuid).","schema":{"type":"string","pattern":"^[0-9a-f-]{8,64}$"}},{"name":"from_search","in":"query","required":false,"description":"The `search_id` of the search this result was opened from. Changes nothing in the answer.","schema":{"type":"string","pattern":"^s_[A-Za-z0-9_-]{22}$"}},{"name":"rank","in":"query","required":false,"description":"The result's position in that search, 1 for the first.","schema":{"type":"integer","minimum":1,"maximum":10000}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ref":{"anyOf":[{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$","description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is."},{"type":"string","maxLength":64,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:archive:file:[0-9]+$","description":"Public id of a stored file: `{country}:archive:file:{n}`, e.g. `dk:archive:file:7`."}],"description":"An id from another answer; matters, consultations and agenda items are then followed."},"note":{"type":"string","maxLength":1000},"pinned":{"type":"boolean"}},"required":["ref"],"additionalProperties":false}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DossierItemResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/dossiers/{id}/items/{item_id}":{"patch":{"operationId":"updateDossierItem","summary":"Change an item's note, or pin it","tags":["core.dossiers"],"x-capability":"core.dossiers","x-replaces":["PATCH /v1/dossiers/{id}/items/{itemId}"],"x-mcp-tools":[],"x-reads":{"core":[],"app":["dossier","dossier_item","dossier_note","dossier_read"]},"x-oauth-scope":"rigsdata:write","parameters":[{"name":"id","in":"path","required":true,"description":"Id of an object in the organisation's account (a uuid).","schema":{"type":"string","pattern":"^[0-9a-f-]{8,64}$"}},{"name":"item_id","in":"path","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"note":{"type":"string","maxLength":1000},"pinned":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DossierItemResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"removeDossierItem","summary":"Remove an item from a dossier","tags":["core.dossiers"],"x-capability":"core.dossiers","x-replaces":["DELETE /v1/dossiers/{id}/items/{itemId}"],"x-mcp-tools":[],"x-reads":{"core":[],"app":["dossier","dossier_item","dossier_note","dossier_read"]},"x-oauth-scope":"rigsdata:write","parameters":[{"name":"id","in":"path","required":true,"description":"Id of an object in the organisation's account (a uuid).","schema":{"type":"string","pattern":"^[0-9a-f-]{8,64}$"}},{"name":"item_id","in":"path","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Deleted"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/dossiers/{id}/notes":{"post":{"operationId":"addDossierNote","summary":"Write a note in a dossier (the organisation's own text)","tags":["core.dossiers"],"x-capability":"core.dossiers","x-replaces":["POST /v1/dossiers/{id}/noter"],"x-mcp-tools":[],"x-reads":{"core":[],"app":["dossier","dossier_item","dossier_note","dossier_read"]},"x-oauth-scope":"rigsdata:write","parameters":[{"name":"id","in":"path","required":true,"description":"Id of an object in the organisation's account (a uuid).","schema":{"type":"string","pattern":"^[0-9a-f-]{8,64}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":4000}},"required":["text"],"additionalProperties":false}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DossierNoteResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/dossiers/{id}/notes/{note_id}":{"delete":{"operationId":"deleteDossierNote","summary":"Delete a note","tags":["core.dossiers"],"x-capability":"core.dossiers","x-replaces":["DELETE /v1/dossiers/{id}/noter/{noteId}"],"x-mcp-tools":[],"x-reads":{"core":[],"app":["dossier","dossier_item","dossier_note","dossier_read"]},"x-oauth-scope":"rigsdata:write","parameters":[{"name":"id","in":"path","required":true,"description":"Id of an object in the organisation's account (a uuid).","schema":{"type":"string","pattern":"^[0-9a-f-]{8,64}$"}},{"name":"note_id","in":"path","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Deleted"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/dossiers/{id}/updates":{"get":{"operationId":"listDossierUpdates","summary":"Items added since the caller's read mark","description":"For an OAuth token the token's user (items the user added do not count), for a key the key. Without a mark: every item. Changes nothing.","tags":["core.dossiers"],"x-capability":"core.dossiers","x-replaces":["GET /v1/dossiers/{id}/nyt"],"x-mcp-tools":["dossier"],"x-reads":{"core":[],"derived":["summary"],"app":["dossier","dossier_item","dossier_note","dossier_read"]},"x-oauth-scope":"rigsdata:write","parameters":[{"name":"id","in":"path","required":true,"description":"Id of an object in the organisation's account (a uuid).","schema":{"type":"string","pattern":"^[0-9a-f-]{8,64}$"}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DossierUpdatesResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/dossiers/{id}/updates/read":{"post":{"operationId":"markDossierRead","summary":"Mark a dossier as read now","tags":["core.dossiers"],"x-capability":"core.dossiers","x-replaces":["POST /v1/dossiers/{id}/nyt/laest"],"x-mcp-tools":["dossier"],"x-reads":{"core":[],"app":["dossier_read"]},"x-oauth-scope":"rigsdata:write","parameters":[{"name":"id","in":"path","required":true,"description":"Id of an object in the organisation's account (a uuid).","schema":{"type":"string","pattern":"^[0-9a-f-]{8,64}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DossierReadResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/exports":{"get":{"operationId":"listExports","summary":"The organisation's exports (a user sees their own), newest first","tags":["core.exports"],"x-capability":"core.exports","x-replaces":["GET /v1/exports"],"x-mcp-tools":["export"],"x-reads":{"core":[],"app":["export_job"]},"parameters":[{"name":"limit","in":"query","required":false,"description":"Items per page (1–50).","schema":{"default":20,"type":"integer","minimum":1,"maximum":50}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportListResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createExport","summary":"Start an export of a list as CSV or XLSX","description":"Runs the route's own query page by page with the same parameters, sources and order, and writes a file kept 7 days. The first page runs at once (bad parameters: 400 now) and the answer estimates rows and lookups. Above 10 lookups nothing is created without `confirm: true`; with `preview=true` never. At most 3 exports running per organisation.","tags":["core.exports"],"x-capability":"core.exports","x-replaces":["POST /v1/exports"],"x-mcp-tools":["export"],"x-reads":{"core":[],"app":["export_job","plans"]},"parameters":[{"name":"preview","in":"query","required":false,"description":"true: estimate only, never create.","schema":{"type":"string","enum":["true","false"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"operation":{"type":"string","pattern":"^[a-z][A-Za-z0-9]{1,60}$","description":"The operationId of an exportable /v2 list route."},"parameters":{"default":{},"description":"The route's own query parameters (without format, cursor and limit).","type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"anyOf":[{"type":"string","maxLength":500},{"type":"number"},{"type":"boolean"},{"maxItems":50,"type":"array","items":{"anyOf":[{"type":"string","maxLength":200},{"type":"number"}]}}]}},"format":{"default":"xlsx","type":"string","enum":["csv","xlsx"]},"separator":{"type":"string","enum":["semicolon","comma"]},"max_rows":{"description":"At most the plan's export_max_rows.","type":"integer","minimum":1,"maximum":9007199254740991},"confirm":{"description":"Needed when the export costs, or may cost, more than 10 lookups.","type":"boolean"}},"required":["operation"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportPreviewResponse"}}}},"201":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportCreatedResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/exports/{id}":{"get":{"operationId":"getExport","summary":"One export and its status","tags":["core.exports"],"x-capability":"core.exports","x-replaces":["GET /v1/exports/{id}"],"x-mcp-tools":["export"],"x-reads":{"core":[],"app":["export_job"]},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"deleteExport","summary":"Delete an export and its file","tags":["core.exports"],"x-capability":"core.exports","x-replaces":["DELETE /v1/exports/{id}"],"x-mcp-tools":[],"x-reads":{"core":[],"app":["export_job"]},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Deleted"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/exports/{id}/download":{"get":{"operationId":"downloadExport","summary":"Download the file","description":"CSV in UTF-8 with BOM and `;` (or `,`), or XLSX. Columns are the list's field names (`source_url` always).","tags":["core.exports"],"x-capability":"core.exports","x-replaces":["GET /v1/exports/{id}/download"],"x-mcp-tools":[],"x-reads":{"core":[],"app":["export_job"]},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"The file.","content":{"text/csv":{"schema":{"type":"string"}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/mail":{"post":{"operationId":"sendMail","summary":"Send one mail to the signed-in user (the assistant's own user)","description":"Only for an OAuth token with a user and the scope `rigsdata:mail`; an API key has no user to mail (403 `mail_requires_user`). The recipient is always the user's verified address. HTML and text are sent unchanged; marks of ours are headers only (sender name, `List-Unsubscribe`). A daily cap per user and UTC day applies (429 `mail_daily_limit`). A bounce, complaint or unsubscribe turns sending off for the user until they turn it on again in the portal (409 `mail_disabled`). A send Mailgun refuses (502 `mail_send_failed`) is not counted and may be retried.","tags":["core.mail"],"x-capability":"core.mail","x-replaces":[],"x-mcp-tools":["send_email_to_me"],"x-reads":{"core":["document","file"],"app":["assistant_mail","assistant_mail_status"]},"x-oauth-scope":"rigsdata:mail","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subject":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[^\\r\\n]*$","description":"The subject line; no line breaks."},"html":{"description":"The HTML part, sent byte for byte as given (no sanitising, wrapping or footer). Gmail clips HTML above about 100 KB.","type":"string","maxLength":1000000},"text":{"description":"The plain-text part; derived from `html` when missing.","type":"string","maxLength":256000},"attachments":{"maxItems":10,"type":"array","items":{"anyOf":[{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[^/\\\\]+$","description":"The file's name as the recipient sees it; no path separators."},"content":{"type":"string","description":"The file's content, as text (`utf8`) or base64. At most 2 MB decoded across all inline attachments (else 413 `mail_too_large`)."},"encoding":{"default":"utf8","type":"string","enum":["utf8","base64"]},"content_type":{"description":"A hint only: the type is decided from the bytes, and a type outside the allowlist is 415 `attachment_type`.","type":"string","maxLength":200,"pattern":"^[a-z0-9][a-z0-9!#$&^_.+-]*\\/[a-z0-9][a-z0-9!#$&^_.+-]*$"}},"required":["filename","content"],"additionalProperties":false,"description":"A file the assistant made itself."},{"type":"object","properties":{"document_id":{"anyOf":[{"type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$","description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is."},{"type":"string","maxLength":64,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:archive:file:[0-9]+$","description":"Public id of a stored file: `{country}:archive:file:{n}`, e.g. `dk:archive:file:7`."}],"description":"A document, publication or legal act id, or a file id (`dk:archive:file:7`), read under the caller's source rules like GET /v2/documents/{id}; its original file name and type are kept."}},"required":["document_id"],"additionalProperties":false,"description":"A stored document, attached from the archive instead of copied into the mail."}]}}},"required":["subject"],"additionalProperties":false,"description":"One mail to the signed-in user. At least one of `html` and `text`. There is no recipient field: `to`, `cc` and `bcc` are refused."}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendMailResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit). This route: `mail_requires_user`, `mail_off_for_org`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"This route: `mail_disabled`, `email_unverified`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"This route: `mail_too_large`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"This route: `attachment_type`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`. This route: `mail_daily_limit`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"This route: `mail_send_failed`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`. This route: `mail_unavailable`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/mail/template":{"get":{"operationId":"getMailTemplate","summary":"The branded template for mail the assistant sends to its user","description":"HTML in the instance's design for `POST /v2/mail`: a frame with the logo, blocks for the body (highlights, section headings, bullet lists, paragraphs, document cards, tables, notes, a button), parts that go inside blocks and inline styles for anything else. The assistant fills it in itself, with whatever it found; the server never renders or changes the mail. The same answer for every caller, in the instance's language.","tags":["core.mail"],"x-capability":"core.mail","x-replaces":[],"x-mcp-tools":["email_template"],"x-reads":{"core":[]},"x-oauth-scope":"rigsdata:mail","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetMailTemplateResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/alerts/sources":{"get":{"operationId":"listAlertSources","summary":"The sources an alert can be restricted to","description":"Each source's key (for `sources`), its name, what it holds and whether alerts watch it yet (`available`): a source still being loaded is off until Rigsdata turns it on after its backfill, and an alert finds nothing in it until then. The same answer for every caller, in the instance's language.","tags":["core.alerts"],"x-capability":"core.alerts","x-replaces":[],"x-mcp-tools":["alerts"],"x-reads":{"core":[]},"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertSourcesResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit). This route: `alert_requires_user`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/alerts":{"get":{"operationId":"listAlerts","summary":"The signed-in user's alerts (overvågninger)","description":"Only for an OAuth token with a user (the alert's owner and the mail's only recipient); an API key alone is 403 `alert_requires_user`. A user sees and changes only their own alerts in the organisation. With the plan's limit of active alerts per user and how many are active.","tags":["core.alerts"],"x-capability":"core.alerts","x-replaces":[],"x-mcp-tools":["alerts"],"x-reads":{"core":[],"app":["alert","alert_hit","plans"]},"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertListResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit). This route: `alert_requires_user`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createAlert","summary":"Create an alert: mail the user when the words turn up in new data","description":"Only for an OAuth token with a user (the alert's owner and the mail's only recipient); an API key alone is 403 `alert_requires_user`. A user sees and changes only their own alerts in the organisation. Every 15 minutes the alert is matched against the documents and records ingested since its last run; new matches go to the user's verified address in one mail per run (at most 25 listed, the rest on the portal). Nothing older than the alert is reported. Nothing has to be scheduled by the caller.","tags":["core.alerts"],"x-capability":"core.alerts","x-replaces":[],"x-mcp-tools":["alerts"],"x-reads":{"core":[],"app":["alert","alert_hit","plans"]},"x-oauth-scope":"rigsdata:write","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":200,"description":"The alert's name, 1 to 100 characters after trimming; on create, blank or absent: the terms in the search syntax."},"terms":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"term":{"type":"string","minLength":1,"maxLength":200},"match":{"default":"word","description":"`word`: the word in every inflection (several words must all occur); `starts_with`, `ends_with`, `contains`: patterns on the word as written (at least 2 letters); `phrase`: the words in sequence; `advanced`: the search syntax as typed.","type":"string","enum":["word","starts_with","ends_with","contains","phrase","advanced"]},"exclude":{"default":false,"description":"True: 'but not'.","type":"boolean"}},"required":["term"],"additionalProperties":false},"description":"What to look for: each a word or phrase with a match mode, optionally excluded ('but not'). At least one term that is not excluded."},"all_terms":{"default":false,"description":"True: every term must occur; default false: any of them.","type":"boolean"},"sources":{"anyOf":[{"maxItems":30,"type":"array","items":{"type":"string","maxLength":50,"pattern":"^[a-z0-9][a-z0-9_-]*$","description":"Slug of a source plugin, as listed by GET /v2/coverage (e.g. `folketing`, `hoeringsportalen`, `kommuner`). The set depends on the instance."}},{"type":"null"}],"description":"Source keys from GET /v2/alerts/sources (an unknown key is 400 `unknown_source`); null or empty: every source, also future ones."},"active":{"default":true,"type":"boolean"}},"required":["terms"],"additionalProperties":false,"description":"A new alert. The plan limits active alerts per user (403 `alert_limit`)."}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...). This route: `invalid_terms`, `unknown_source`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit). This route: `alert_requires_user`, `alert_limit`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/alerts/{id}":{"get":{"operationId":"getAlert","summary":"One of the user's alerts","description":"Only for an OAuth token with a user (the alert's owner and the mail's only recipient); an API key alone is 403 `alert_requires_user`. A user sees and changes only their own alerts in the organisation.","tags":["core.alerts"],"x-capability":"core.alerts","x-replaces":[],"x-mcp-tools":["alerts"],"x-reads":{"core":[],"app":["alert","alert_hit"]},"parameters":[{"name":"id","in":"path","required":true,"description":"Id of an alert, `alr_` and a random part.","schema":{"type":"string","pattern":"^alr_[A-Za-z0-9_-]{8,64}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit). This route: `alert_requires_user`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"updateAlert","summary":"Change, pause or resume one of the user's alerts","description":"Only for an OAuth token with a user (the alert's owner and the mail's only recipient); an API key alone is 403 `alert_requires_user`. A user sees and changes only their own alerts in the organisation. Only the fields given change. Resuming (active true) counts against the plan's limit and starts from now.","tags":["core.alerts"],"x-capability":"core.alerts","x-replaces":[],"x-mcp-tools":["alerts"],"x-reads":{"core":[],"app":["alert","alert_hit","plans"]},"x-oauth-scope":"rigsdata:write","parameters":[{"name":"id","in":"path","required":true,"description":"Id of an alert, `alr_` and a random part.","schema":{"type":"string","pattern":"^alr_[A-Za-z0-9_-]{8,64}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":200,"description":"The alert's name, 1 to 100 characters after trimming; on create, blank or absent: the terms in the search syntax."},"terms":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"term":{"type":"string","minLength":1,"maxLength":200},"match":{"default":"word","description":"`word`: the word in every inflection (several words must all occur); `starts_with`, `ends_with`, `contains`: patterns on the word as written (at least 2 letters); `phrase`: the words in sequence; `advanced`: the search syntax as typed.","type":"string","enum":["word","starts_with","ends_with","contains","phrase","advanced"]},"exclude":{"default":false,"description":"True: 'but not'.","type":"boolean"}},"required":["term"],"additionalProperties":false}},"all_terms":{"type":"boolean"},"sources":{"anyOf":[{"maxItems":30,"type":"array","items":{"type":"string","maxLength":50,"pattern":"^[a-z0-9][a-z0-9_-]*$","description":"Slug of a source plugin, as listed by GET /v2/coverage (e.g. `folketing`, `hoeringsportalen`, `kommuner`). The set depends on the instance."}},{"type":"null"}],"description":"Source keys from GET /v2/alerts/sources (an unknown key is 400 `unknown_source`); null or empty: every source, also future ones."},"active":{"description":"False pauses the alert; true resumes it from now (the plan's limit applies).","type":"boolean"}},"additionalProperties":false,"description":"Only the fields given change."}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...). This route: `invalid_terms`, `unknown_source`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit). This route: `alert_requires_user`, `alert_limit`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"deleteAlert","summary":"Delete one of the user's alerts with its hits","description":"Only for an OAuth token with a user (the alert's owner and the mail's only recipient); an API key alone is 403 `alert_requires_user`. A user sees and changes only their own alerts in the organisation.","tags":["core.alerts"],"x-capability":"core.alerts","x-replaces":[],"x-mcp-tools":["alerts"],"x-reads":{"core":[],"app":["alert","alert_hit"]},"x-oauth-scope":"rigsdata:write","parameters":[{"name":"id","in":"path","required":true,"description":"Id of an alert, `alr_` and a random part.","schema":{"type":"string","pattern":"^alr_[A-Za-z0-9_-]{8,64}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Deleted"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit). This route: `alert_requires_user`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/alerts/{id}/hits":{"get":{"operationId":"listAlertHits","summary":"What one of the user's alerts found, newest first","description":"Only for an OAuth token with a user (the alert's owner and the mail's only recipient); an API key alone is 403 `alert_requires_user`. A user sees and changes only their own alerts in the organisation. The last 90 days.","tags":["core.alerts"],"x-capability":"core.alerts","x-replaces":[],"x-mcp-tools":["alerts"],"x-reads":{"core":[],"app":["alert","alert_hit"]},"parameters":[{"name":"id","in":"path","required":true,"description":"Id of an alert, `alr_` and a random part.","schema":{"type":"string","pattern":"^alr_[A-Za-z0-9_-]{8,64}$"}},{"name":"limit","in":"query","required":false,"description":"Items per page (1–100).","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page; tied to the same parameters.","schema":{"type":"string","maxLength":1024}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertHitsResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit). This route: `alert_requires_user`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/feedback":{"post":{"operationId":"sendFeedback","summary":"Send the user's feedback about Rigsdata","description":"Stores one piece of feedback with the caller's organisation and user (an API key's organisation and key). Only send what the user approved word for word. Any credential may send it; it is not counted as a lookup. A cap per user (or key) and UTC day applies (429 `feedback_daily_limit`).","tags":["core.feedback"],"x-capability":"core.feedback","x-replaces":[],"x-mcp-tools":["send_feedback"],"x-reads":{"core":[],"app":["feedback","feedback_hint"]},"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","enum":["works_well","not_working","missing_feature","source_request","other"],"description":"`works_well` (praise), `not_working` (something failed or answered wrongly), `missing_feature`, `source_request` (a source Rigsdata should cover), `other`."},"message":{"type":"string","minLength":3,"maxLength":4000,"description":"The feedback in the user's words, exactly as shown to the user and approved by them."},"tool":{"description":"The tool the feedback is about (`search`, `get_matter`), when it is about one.","type":"string","maxLength":100},"query":{"description":"The query or arguments that gave the answer the feedback is about.","type":"string","maxLength":1000},"document":{"description":"A document id or link the feedback is about.","type":"string","maxLength":500},"client":{"description":"The assistant or client sending it (`Claude`, `ChatGPT`, `Copilot`), when known.","type":"string","maxLength":100}},"required":["category","message"],"additionalProperties":false,"description":"One piece of feedback from the user, sent with their explicit consent."}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendFeedbackResponse"}}}},"400":{"description":"Invalid request (`invalid_query`, `invalid_cursor`, `invalid_id`, `ambiguous_name`, ...).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid credential (`missing_api_key`, `invalid_api_key`, `key_expired`, `key_disabled`, `invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed (`key_source_restricted`, `insufficient_scope`, a plan limit).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found (`not_found`, `wrong_entity_type`, `capability_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (`rate_limited`, `too_many_concurrent`, `quota_exceeded`); see `Retry-After`. This route: `feedback_daily_limit`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stopped or unavailable (`query_timeout`, `overloaded`, `auth_unavailable`); see `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"An API key (`rd_live_…`) or an OAuth access token."}},"schemas":{"EntityId":{"$id":"#/components/schemas/EntityId","type":"string","maxLength":512,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?:[a-z](?:[a-z0-9-]*[a-z0-9])?:[A-Za-z0-9._~-]+(?::[A-Za-z0-9._~-]+)*$","description":"Public id of a core entity, `{place}:{publisher}:{native-type}:{native-id}`, e.g. `dk:folketing:sag:106086`, `dk:kommune-0101:punkt:88412`. Stable across classification changes; never parse it, pass it back as it is."},"JurisdictionId":{"$id":"#/components/schemas/JurisdictionId","type":"string","maxLength":100,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?(?::[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)?$","description":"Jurisdiction id: the country (`dk`), a subdivision (`de-by`) or a local authority's namespace (`dk:kommune-0101`)."},"FileId":{"$id":"#/components/schemas/FileId","type":"string","maxLength":64,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:archive:file:[0-9]+$","description":"Public id of a stored file: `{country}:archive:file:{n}`, e.g. `dk:archive:file:7`."},"SourceSlug":{"$id":"#/components/schemas/SourceSlug","type":"string","maxLength":50,"pattern":"^[a-z0-9][a-z0-9_-]*$","description":"Slug of a source plugin, as listed by GET /v2/coverage (e.g. `folketing`, `hoeringsportalen`, `kommuner`). The set depends on the instance."},"EntityType":{"$id":"#/components/schemas/EntityType","type":"string","enum":["jurisdiction","body","organization","person","post","term","matter","matter_action","document","file","meeting","agenda_item","decision","vote_event","speech","consultation","consultation_response","legal_act","publication","procurement_notice","ruling"],"description":"The core entity an id names."},"Day":{"$id":"#/components/schemas/Day","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"A calendar day, `YYYY-MM-DD`, in the instance's time zone."},"DateTime":{"$id":"#/components/schemas/DateTime","type":"string","allOf":[{"pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"pattern":"[+-]\\d{2}:\\d{2}$"}],"description":"An instant as ISO 8601 with the instance zone's offset valid at that moment, e.g. `2026-10-22T08:10:00+02:00` (summer) or `2026-12-01T09:00:00+01:00` (winter). Never `Z`."},"DayOrDateTime":{"$id":"#/components/schemas/DayOrDateTime","anyOf":[{"$ref":"#/components/schemas/Day"},{"$ref":"#/components/schemas/DateTime"}],"description":"A day (`YYYY-MM-DD`) when the source gives no time of day, else a date-time."},"Quota":{"$id":"#/components/schemas/Quota","type":"object","properties":{"exceeded":{"type":"boolean"},"message":{"type":"string","description":"Localised note for the account owner."}},"required":["exceeded","message"],"additionalProperties":false,"description":"Present when the organisation is past its period's lookups but still served. A note to the account owner, not part of the answer: clients and assistants do not repeat it to end users."},"CoverageSource":{"$id":"#/components/schemas/CoverageSource","type":"object","properties":{"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string"},"last_fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"earliest_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"latest_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"current":{"description":"Fetched within its freshness promise.","type":["boolean","null"]},"text_pending":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Documents whose text is not read yet."},"text_blocked":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Documents the source refuses to serve."}},"required":["source","source_name","last_fetched_at","earliest_date","latest_date","current","text_pending","text_blocked"],"additionalProperties":false},"CoverageUnitGap":{"$id":"#/components/schemas/CoverageUnitGap","type":"object","properties":{"id":{"type":"string","description":"Jurisdiction or organization id of the unit."},"name":{"type":"string"},"coverage":{"type":"string","enum":["partial","none"]},"reason":{"type":"string","description":"Localised reason (catalogue `api.coverage.gaps.*`)."}},"required":["id","name","coverage","reason"],"additionalProperties":false},"CoverageUnits":{"$id":"#/components/schemas/CoverageUnits","type":"object","properties":{"source":{"$ref":"#/components/schemas/SourceSlug"},"unit_type":{"type":"string","enum":["jurisdiction","organization"],"description":"Units are jurisdictions (municipalities, regions) or organizations (ministries, parties)."},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"full":{"type":"integer","minimum":0,"maximum":9007199254740991},"partial":{"type":"integer","minimum":0,"maximum":9007199254740991},"none":{"type":"integer","minimum":0,"maximum":9007199254740991},"missing":{"maxItems":10,"type":"array","items":{"$ref":"#/components/schemas/CoverageUnitGap"}},"more_missing":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["source","unit_type","total","full","partial","none","missing","more_missing"],"additionalProperties":false},"Coverage":{"$id":"#/components/schemas/Coverage","type":"object","properties":{"complete":{"type":"boolean","description":"True only when `caveats` is empty."},"scope_text":{"type":"string","description":"Localised sentence: what the lookup covered."},"caveats":{"type":"array","items":{"type":"string"},"description":"Localised known caveats: units not or partly covered, a period before a source starts, text not read yet, a source fetched later than promised."},"computed_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the coverage snapshot was computed."},"period":{"anyOf":[{"type":"object","properties":{"from_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"to_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]}},"required":["from_date","to_date"],"additionalProperties":false},{"type":"null"}]},"sources":{"type":"array","items":{"$ref":"#/components/schemas/CoverageSource"}},"units":{"type":"array","items":{"$ref":"#/components/schemas/CoverageUnits"}},"attestation_id":{"anyOf":[{"type":"string","pattern":"^[0-9A-Za-z]{22}$"},{"type":"null"}]},"attestation_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The attestation's page in the customer portal."}},"required":["complete","scope_text","caveats","computed_at","period","sources","units","attestation_id","attestation_url"],"additionalProperties":false,"description":"What the answer covered and the known caveats. Read `caveats` before concluding that something does not exist. The attestation is kept 12 months (GET /v2/attestations/{id})."},"TermRef":{"$id":"#/components/schemas/TermRef","type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"name":{"type":"string","description":"As the source names it, e.g. `2025-26 (1. samling)`."},"kind":{"type":"string","enum":["legislative-term","session","session.extraordinary","fiscal-year","other"]}},"required":["id","name","kind"],"additionalProperties":false},"ActorRef":{"$id":"#/components/schemas/ActorRef","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"actor_type":{"type":"string","enum":["person","organization","post"]},"name":{"type":"string"},"role":{"anyOf":[{"type":"string","enum":["sponsor","cosponsor","minister-responsible","minister-coresponsible","committee-lead","committee-advisory","rapporteur","asker","answerer","addressee","sender","author","speaker","chair","attendee","organizer","respondent","recipient","buyer","contractor","other"]},{"type":"null"}]},"role_label":{"type":["string","null"]},"role_native":{"type":["string","null"]},"party":{"description":"A person's party short name, where the source gives one.","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The actor's page at the source; null when it has none."},"holder":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","name","source_url"],"additionalProperties":false},{"type":"null"}],"description":"For a post (a minister's title): who held it on the date in question."}},"required":["id","actor_type","name","role","role_label","role_native","party","source_url","holder"],"additionalProperties":false},"Item":{"$id":"#/components/schemas/Item","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source"],"additionalProperties":false},"FacetValue":{"$id":"#/components/schemas/FacetValue","type":"object","properties":{"value":{"type":"string"},"label":{"type":["string","null"]},"count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["value","label","count"],"additionalProperties":false},"Filters":{"$id":"#/components/schemas/Filters","type":"object","propertyNames":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"},"additionalProperties":{},"description":"The parameters as applied, after defaults and name resolution."},"Deleted":{"$id":"#/components/schemas/Deleted","type":"object","properties":{"deleted":{"type":"boolean","const":true},"id":{"type":"string"},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["deleted","id","message"],"additionalProperties":false},"ErrorCode":{"$id":"#/components/schemas/ErrorCode","type":"string","enum":["invalid_query","invalid_cursor","invalid_id","missing_query","ambiguous_name","invalid_format","payload_too_large","invalid_terms","unknown_source","missing_api_key","invalid_api_key","key_expired","key_disabled","invalid_token","insufficient_scope","organization_required","user_required","key_source_restricted","dossier_limit","calendar_limit","note_limit","export_not_in_plan","mail_requires_user","mail_off_for_org","alert_requires_user","alert_limit","not_found","wrong_entity_type","capability_disabled","attestation_not_ready","not_ready","already_added","dossier_full","dossier_archived","export_busy","gone","withdrawn","mail_disabled","email_unverified","mail_too_large","attachment_type","rate_limited","too_many_concurrent","quota_exceeded","usage_exceeded","mail_daily_limit","feedback_daily_limit","query_timeout","overloaded","auth_unavailable","export_unavailable","mail_send_failed","mail_unavailable","internal_error"]},"Error":{"$id":"#/components/schemas/Error","type":"object","properties":{"error":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string","description":"Localised: what went wrong and what to do next."},"request_id":{"type":"string"},"issues":{"description":"For `invalid_query`: each parameter that failed and why.","type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retry_after_ms":{"type":"integer","minimum":0,"maximum":9007199254740991},"candidates":{"description":"For `ambiguous_name`: the matches to choose from.","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"detail":{"type":["string","null"]}},"required":["id","name","detail"],"additionalProperties":false}},"entity_type":{"description":"For `wrong_entity_type`: what the id names.","$ref":"#/components/schemas/EntityType"},"capability":{"description":"For `capability_disabled`: the module.","type":"string"}},"required":["error","message"],"additionalProperties":false,"description":"Every error answer. `error` is a stable English code; `message` is localised."},"Deadline":{"$id":"#/components/schemas/Deadline","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"event_type":{"type":"string","enum":["consultation_deadline","appeal_deadline","answer_deadline","committee_deadline","reading","consultation_meeting","plenary_meeting","committee_meeting","council_meeting"]},"event_type_label":{"type":"string"},"start":{"description":"A day for an all-day deadline, else the meeting's start.","$ref":"#/components/schemas/DayOrDateTime"},"end":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"all_day":{"type":"boolean"},"event_status":{"anyOf":[{"type":"string","enum":["cancelled","postponed"]},{"type":"null"}]},"uid":{"type":"string","description":"The calendar event's UID, stable when the deadline moves."},"description":{"description":"Localised, as the calendar shows it.","type":["string","null"]}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","event_type","event_type_label","start","end","all_day","event_status","uid","description"],"additionalProperties":false},"DeadlinesResponse":{"$id":"#/components/schemas/DeadlinesResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Deadline"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","next_cursor","filters","message"],"additionalProperties":false},"SearchTerm":{"$id":"#/components/schemas/SearchTerm","type":"object","properties":{"term":{"type":"string","minLength":1,"maxLength":200},"match":{"default":"word","description":"`word`: the word in every inflection (several words must all occur); `starts_with`, `ends_with`, `contains`: patterns on the word as written (at least 2 letters); `phrase`: the words in sequence; `advanced`: the search syntax as typed.","type":"string","enum":["word","starts_with","ends_with","contains","phrase","advanced"]},"exclude":{"default":false,"description":"True: 'but not'.","type":"boolean"}},"required":["term","match","exclude"],"additionalProperties":false},"CalendarFilters":{"$id":"#/components/schemas/CalendarFilters","type":"object","properties":{"event_types":{"maxItems":9,"type":"array","items":{"type":"string","enum":["consultation_deadline","appeal_deadline","answer_deadline","committee_deadline","reading","consultation_meeting","plenary_meeting","committee_meeting","council_meeting"]}},"source":{"maxItems":20,"type":"array","items":{"$ref":"#/components/schemas/SourceSlug"}},"terms":{"minItems":1,"maxItems":20,"type":"array","items":{"$ref":"#/components/schemas/SearchTerm"}},"all_terms":{"type":"boolean"},"query":{"type":"string","minLength":1,"maxLength":200},"jurisdiction":{"maxItems":100,"type":"array","items":{"$ref":"#/components/schemas/JurisdictionId"}},"authority":{"maxItems":50,"type":"array","items":{"type":"string","minLength":2,"maxLength":200}},"matters":{"maxItems":50,"type":"array","items":{"$ref":"#/components/schemas/EntityId"}},"consultations":{"maxItems":50,"type":"array","items":{"$ref":"#/components/schemas/EntityId"}}},"additionalProperties":false},"CalendarDraft":{"$id":"#/components/schemas/CalendarDraft","type":"object","properties":{"name":{"type":"string"},"filters":{"$ref":"#/components/schemas/CalendarFilters"},"description":{"type":"string","description":"Localised: what the calendar shows."}},"required":["name","filters","description"],"additionalProperties":false},"Calendar":{"$id":"#/components/schemas/Calendar","type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f-]{8,64}$","description":"Id of an object in the organisation's account (a uuid)."},"name":{"type":"string"},"filters":{"$ref":"#/components/schemas/CalendarFilters"},"description":{"type":"string","description":"Localised: what the calendar shows."},"key_prefix":{"type":"string","description":"The first characters of the address's token."},"created_at":{"$ref":"#/components/schemas/DateTime"},"last_fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"revoked_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"active":{"type":"boolean"}},"required":["id","name","filters","description","key_prefix","created_at","last_fetched_at","revoked_at","active"],"additionalProperties":false},"CalendarListResponse":{"$id":"#/components/schemas/CalendarListResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Calendar"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"plan_limit":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The plan's limit; null: no limit."},"used":{"type":"integer","minimum":0,"maximum":9007199254740991},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","plan_limit","used","message"],"additionalProperties":false},"CalendarPreviewResponse":{"$id":"#/components/schemas/CalendarPreviewResponse","type":"object","properties":{"preview":{"type":"boolean","const":true},"created":{"type":"boolean","const":false},"item":{"$ref":"#/components/schemas/CalendarDraft"},"plan_limit":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The plan's limit; null: no limit."},"used":{"type":"integer","minimum":0,"maximum":9007199254740991},"message":{"type":"string","description":"Localised: what would be created, for the user to confirm."},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["preview","created","item","plan_limit","used","message"],"additionalProperties":false},"CalendarCreatedResponse":{"$id":"#/components/schemas/CalendarCreatedResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/Calendar"},"url":{"type":"string","maxLength":2048,"format":"uri","description":"The feed's address, shown this once and never stored readable."},"webcal_url":{"type":"string","pattern":"^webcal:\\/\\/"},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["item","url","webcal_url","message"],"additionalProperties":false},"CalendarRevokedResponse":{"$id":"#/components/schemas/CalendarRevokedResponse","type":"object","properties":{"revoked":{"type":"boolean","const":true},"id":{"type":"string","pattern":"^[0-9a-f-]{8,64}$","description":"Id of an object in the organisation's account (a uuid)."},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["revoked","id","message"],"additionalProperties":false},"Alert":{"$id":"#/components/schemas/Alert","type":"object","properties":{"id":{"type":"string","pattern":"^alr_[A-Za-z0-9_-]{8,64}$","description":"Id of an alert, `alr_` and a random part."},"name":{"type":"string"},"terms":{"minItems":1,"maxItems":20,"type":"array","items":{"$ref":"#/components/schemas/SearchTerm"}},"all_terms":{"type":"boolean","description":"True: every term that is not excluded must occur; false: any of them."},"sources":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/SourceSlug"}},{"type":"null"}],"description":"Null: every source, also future ones."},"unavailable_sources":{"type":"array","items":{"$ref":"#/components/schemas/SourceSlug"},"description":"The alert's own sources that alerts do not watch yet (`available` false in GET /v2/alerts/sources: still being loaded): the alert finds nothing there until Rigsdata turns them on. Empty when sources is null (every source turned on is watched)."},"active":{"type":"boolean","description":"False: paused; nothing is evaluated or mailed."},"paused_reason":{"anyOf":[{"type":"string","enum":["user","unsubscribed","too_heavy"]},{"type":"null"}],"description":"Why the alert is paused; null while active. `user`: paused by the user (the portal, the API or the assistant); `unsubscribed`: paused by the one-click pause link in an alert mail; `too_heavy`: paused by Rigsdata because its search ran into its time limit 5 runs in a row (narrower terms or fewer sources, then resume). Resuming clears it."},"created_at":{"$ref":"#/components/schemas/DateTime"},"updated_at":{"$ref":"#/components/schemas/DateTime"},"last_mailed_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"hit_count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Hits kept (the last 90 days)."}},"required":["id","name","terms","all_terms","sources","unavailable_sources","active","paused_reason","created_at","updated_at","last_mailed_at","hit_count"],"additionalProperties":false},"AlertHit":{"$id":"#/components/schemas/AlertHit","type":"object","properties":{"item_id":{"type":"string","description":"The document, consultation or file the hit is: pass it to GET /v2/documents/{id} or GET /v2/resolve/{id}."},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source to cite."},"title":{"type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The source's own page or file."},"published_at":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"excerpt":{"description":"Where the words occur: escaped HTML whose only markup is `<b>` around them.","type":["string","null"]},"older_document":{"type":"boolean","description":"True: an older document. Its own date (published_at) is more than 30 days before matched_at; it was only fetched now (for example by a backfill of a source's archive), not newly published. Say so when showing the hit."},"matched_at":{"allOf":[{"pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"pattern":"[+-]\\d{2}:\\d{2}$"}],"description":"When the alert found it.","$ref":"#/components/schemas/DateTime"},"mailed_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When it was mailed; null: in the next mail."}},"required":["item_id","source","source_name","title","source_url","published_at","excerpt","older_document","matched_at","mailed_at"],"additionalProperties":false},"AlertSource":{"$id":"#/components/schemas/AlertSource","type":"object","properties":{"key":{"$ref":"#/components/schemas/SourceSlug"},"name":{"type":"string","description":"Localised: the source as the mail names it."},"covers":{"type":"string","description":"Localised: what the source holds."},"available":{"type":"boolean","description":"True: alerts watch this source. False: the source is still being loaded (its archive backfilled), so every old document would look new; it can still be chosen, but an alert finds nothing in it until Rigsdata turns it on."},"available_since":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When alerts started watching the source; nothing it fetched before is reported. Null while not available."}},"required":["key","name","covers","available","available_since"],"additionalProperties":false},"AlertListResponse":{"$id":"#/components/schemas/AlertListResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Alert"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"plan_limit":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The plan's limit; null: no limit."},"used":{"type":"integer","minimum":0,"maximum":9007199254740991},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","plan_limit","used","message"],"additionalProperties":false},"AlertResponse":{"$id":"#/components/schemas/AlertResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/Alert"},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["item","message"],"additionalProperties":false},"AlertHitsResponse":{"$id":"#/components/schemas/AlertHitsResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/AlertHit"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"next_cursor":{"type":["string","null"]},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","next_cursor","message"],"additionalProperties":false},"AlertSourcesResponse":{"$id":"#/components/schemas/AlertSourcesResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/AlertSource"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","message"],"additionalProperties":false},"ChangeId":{"$id":"#/components/schemas/ChangeId","type":"string","maxLength":64,"pattern":"^[a-z]{2}(?:-[a-z0-9]{1,3})?:archive:change:[0-9]+$","description":"Public id of a recorded change: `{country}:archive:change:{n}`."},"FieldChange":{"$id":"#/components/schemas/FieldChange","type":"object","properties":{"field":{"type":"string"},"before":{"type":["string","null"]},"after":{"type":["string","null"]}},"required":["field","before","after"],"additionalProperties":false},"Change":{"$id":"#/components/schemas/Change","type":"object","properties":{"id":{"$ref":"#/components/schemas/ChangeId"},"kind":{"type":"string","enum":["new_version","fields","removed","restored"]},"kind_label":{"type":"string"},"at":{"allOf":[{"pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"pattern":"[+-]\\d{2}:\\d{2}$"}],"description":"When the instance saw the change.","$ref":"#/components/schemas/DateTime"},"description":{"type":"string"},"text_unchanged":{"type":["boolean","null"]},"pages_changed":{"type":"array","items":{"type":"integer","minimum":0,"maximum":9007199254740991}},"chars_added":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"chars_removed":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"fields":{"type":"array","items":{"$ref":"#/components/schemas/FieldChange"},"description":"Values cut at 300 characters in the list; whole in GET /v2/changes/{id}."},"removed_since":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"withdrawn":{"type":"boolean","description":"Withdrawn by the source: only the fact and the time are shown."}},"required":["id","kind","kind_label","at","description","text_unchanged","pages_changed","chars_added","chars_removed","fields","removed_since","withdrawn"],"additionalProperties":false},"ChangeItem":{"$id":"#/components/schemas/ChangeItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"change":{"$ref":"#/components/schemas/Change"}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","change"],"additionalProperties":false},"ChangesResponse":{"$id":"#/components/schemas/ChangesResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ChangeItem"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"coverage":{"$ref":"#/components/schemas/Coverage"},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","next_cursor","filters","message"],"additionalProperties":false},"DiffHunk":{"$id":"#/components/schemas/DiffHunk","type":"object","properties":{"page_before":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"page_after":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"context":{"type":["string","null"]},"removed":{"type":"array","items":{"type":"string"}},"added":{"type":"array","items":{"type":"string"}}},"required":["page_before","page_after","context","removed","added"],"additionalProperties":false},"ChangeDetailResponse":{"$id":"#/components/schemas/ChangeDetailResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/ChangeItem"},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"},"version_from":{"anyOf":[{"type":"object","properties":{"number":{"type":"integer","minimum":1,"maximum":9007199254740991},"from":{"$ref":"#/components/schemas/DateTime"},"sha256":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]}},"required":["number","from","sha256"],"additionalProperties":false},{"type":"null"}]},"version_to":{"anyOf":[{"type":"object","properties":{"number":{"type":"integer","minimum":1,"maximum":9007199254740991},"from":{"$ref":"#/components/schemas/DateTime"},"sha256":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]}},"required":["number","from","sha256"],"additionalProperties":false},{"type":"null"}]},"diff":{"anyOf":[{"type":"object","properties":{"hunks":{"type":"array","items":{"$ref":"#/components/schemas/DiffHunk"}},"truncated":{"type":"boolean"},"omitted":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["hunks","truncated","omitted"],"additionalProperties":false},{"type":"null"}],"description":"For `new_version` only; null for other kinds, the same text, and a withdrawn document."}},"required":["item","message","version_from","version_to","diff"],"additionalProperties":false},"MatterRef":{"$id":"#/components/schemas/MatterRef","type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"reference":{"type":["string","null"]},"title":{"type":["string","null"]},"term":{"anyOf":[{"$ref":"#/components/schemas/TermRef"},{"type":"null"}]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","reference","title","term","source_url"],"additionalProperties":false},"OrganizationRef":{"$id":"#/components/schemas/OrganizationRef","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","name","source_url"],"additionalProperties":false},"MeetingRef":{"$id":"#/components/schemas/MeetingRef","type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"number":{"type":["string","null"]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]}},"required":["id","number","title","date"],"additionalProperties":false},"DocumentRef":{"$id":"#/components/schemas/DocumentRef","type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"file_id":{"anyOf":[{"$ref":"#/components/schemas/FileId"},{"type":"null"}],"description":"Read its text with GET /v2/documents/{id}/pages; null without a file."},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","title","date","document_type","document_type_label","document_type_native","file_id","source_url"],"additionalProperties":false},"PageReference":{"$id":"#/components/schemas/PageReference","type":"object","properties":{"text":{"type":"string","description":"The words that refer, as written."},"matter":{"anyOf":[{"$ref":"#/components/schemas/MatterRef"},{"type":"null"}],"description":"The matter the reference is on, when known."},"question_text":{"description":"The question's wording, when the source records it (the answer carries it).","type":["string","null"]},"documents":{"maxItems":5,"type":"array","items":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"title":{"type":["string","null"]},"date":{"type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]},"file_id":{"anyOf":[{"$ref":"#/components/schemas/FileId"},{"type":"null"}],"description":"The file meant (an enclosed bilag: its own file); read it with GET /v2/documents/{id}/pages?file=."}},"required":["id","document_type","document_type_label","title","date","source_url","file_id"],"additionalProperties":false},"description":"Answers first, then newest first; at most five."}},"required":["text","matter","question_text","documents"],"additionalProperties":false,"description":"A question, samrådsspørgsmål or bilag the text refers to, with the documents meant, answers first."},"FileRef":{"$id":"#/components/schemas/FileRef","type":"object","properties":{"file_id":{"$ref":"#/components/schemas/FileId"},"title":{"type":["string","null"]},"format":{"description":"Detected from the content (pdf, docx, html, ...).","type":["string","null"]},"page_count":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["file_id","title","format","page_count","source_url"],"additionalProperties":false},"DocumentTypeCount":{"$id":"#/components/schemas/DocumentTypeCount","type":"object","properties":{"document_type":{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},"label":{"type":"string"},"native":{"type":["string","null"]},"count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["document_type","label","native","count"],"additionalProperties":false},"Bill":{"$id":"#/components/schemas/Bill","type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"reference":{"type":["string","null"]},"term":{"anyOf":[{"$ref":"#/components/schemas/TermRef"},{"type":"null"}]},"title":{"type":["string","null"]},"link_method":{"type":"string","enum":["description","title","relation"]},"previous":{"type":"array","items":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"reference":{"type":["string","null"]},"term":{"anyOf":[{"$ref":"#/components/schemas/TermRef"},{"type":"null"}]},"title":{"type":["string","null"]}},"required":["id","reference","term","title"],"additionalProperties":false},"description":"The same bill introduced before (e.g. before an election)."}},"required":["id","reference","term","title","link_method","previous"],"additionalProperties":false,"description":"The bill the consultation became or builds on."},"ConsultationItem":{"$id":"#/components/schemas/ConsultationItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"consultation_type":{"type":"string","enum":["public","targeted","call-for-evidence","citizen-dialogue","appeal-notice","other"]},"consultation_type_label":{"type":"string"},"deadline":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"The end of the deadline day in the jurisdiction's zone."},"appeal_deadline":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["open","closed","archived"]},{"type":"null"}],"description":"By the deadline against today, like the filter."},"status_label":{"type":["string","null"]},"consultation_status":{"anyOf":[{"type":"string","enum":["planned","open","closed","outcome-published","withdrawn","other"]},{"type":"null"}]},"consultation_status_native":{"description":"The source's own status.","type":["string","null"]},"subjects":{"type":"array","items":{"type":"string"}},"document_counts":{"type":"array","items":{"$ref":"#/components/schemas/DocumentTypeCount"}},"response_count":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Response documents listed by the source; null when it lists none (not the same as no responses)."},"responses_combined":{"type":"boolean","description":"The responses are one combined document."},"bill":{"anyOf":[{"$ref":"#/components/schemas/Bill"},{"type":"null"}]},"parliament_response_files":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/FileId"}},{"type":"null"}],"description":"The bill's appendix files with responses and memo in parliament."}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","consultation_type","consultation_type_label","deadline","appeal_deadline","status","status_label","consultation_status","consultation_status_native","subjects","document_counts","response_count","responses_combined","bill","parliament_response_files"],"additionalProperties":false},"ListConsultationsResponse":{"$id":"#/components/schemas/ListConsultationsResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ConsultationItem"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"interpretation":{"description":"Localised: how the query was read (dropped words, broadening, semantic hits).","type":["string","null"]},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"coverage":{"$ref":"#/components/schemas/Coverage"},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","next_cursor","filters","interpretation","message"],"additionalProperties":false},"StakeholderRef":{"$id":"#/components/schemas/StakeholderRef","type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"name":{"type":"string"},"category":{"anyOf":[{"type":"string","enum":["company","business-association","ngo","interest-group","trade-union","public-authority","academic","citizen","other"]},{"type":"null"}]},"category_label":{"type":["string","null"]}},"required":["id","name","category","category_label"],"additionalProperties":false},"ConsultationResponse":{"$id":"#/components/schemas/ConsultationResponse","type":"object","properties":{"document_id":{"$ref":"#/components/schemas/EntityId"},"title":{"description":"Null for a private person's response.","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"Null for a private person's response."},"respondent_type":{"type":"string","enum":["organization","public-authority","person","combined","unknown"]},"stakeholder":{"anyOf":[{"$ref":"#/components/schemas/StakeholderRef"},{"type":"null"}]},"sender":{"description":"The sender as the response names it; never a private person's name.","type":["string","null"]},"no_comments":{"type":["boolean","null"]},"position":{"anyOf":[{"type":"string","enum":["supports","opposes","mixed","no_comments","unclear"]},{"type":"null"}],"description":"Machine-read unless no_comments."},"position_label":{"type":["string","null"]}},"required":["document_id","title","source_url","respondent_type","stakeholder","sender","no_comments","position","position_label"],"additionalProperties":false,"description":"One response. A private person has no stakeholder and no name (ADR 0015)."},"Invited":{"$id":"#/components/schemas/Invited","type":"object","properties":{"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"responded":{"type":"integer","minimum":0,"maximum":9007199254740991},"response_rate":{"type":"number","minimum":0,"maximum":1},"stakeholders":{"type":"array","items":{"type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"name":{"type":"string"},"responded":{"type":"boolean"}},"required":["id","name","responded"],"additionalProperties":false}}},"required":["count","responded","response_rate","stakeholders"],"additionalProperties":false},"ChangeAfterConsultation":{"$id":"#/components/schemas/ChangeAfterConsultation","type":"object","properties":{"text":{"type":"string","maxLength":500,"description":"Verbatim excerpt of the memo."},"topic":{"type":["string","null"]},"stakeholders":{"type":"array","items":{"type":"object","properties":{"stakeholder":{"$ref":"#/components/schemas/StakeholderRef"},"role":{"type":"string","enum":["proposed","supported","mentioned"]},"role_label":{"type":"string"},"explicit":{"type":"boolean","description":"The memo itself credits the organisation."}},"required":["stakeholder","role","role_label","explicit"],"additionalProperties":false}},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The memo."},"document_id":{"$ref":"#/components/schemas/EntityId"},"page":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}]},"memo_source":{"type":"string","enum":["consultation","parliament"],"description":"The consultation's own memo, or the bill's appendix in parliament."},"kind":{"type":"string","enum":["content","editorial"]},"prompted_by":{"type":"string","enum":["consultation","own"],"description":"`own`: the authority's own change, not due to the consultation."},"found_in":{"type":"string","enum":["changes_section","topic"]},"method":{"type":"string","enum":["rule","llm"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["text","topic","stakeholders","source_url","document_id","page","memo_source","kind","prompted_by","found_in","method","confidence"],"additionalProperties":false,"description":"A change the consultation memo says was made."},"ConsultationDetailItem":{"$id":"#/components/schemas/ConsultationDetailItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"consultation_type":{"type":"string","enum":["public","targeted","call-for-evidence","citizen-dialogue","appeal-notice","other"]},"consultation_type_label":{"type":"string"},"deadline":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"The end of the deadline day in the jurisdiction's zone."},"appeal_deadline":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["open","closed","archived"]},{"type":"null"}],"description":"By the deadline against today, like the filter."},"status_label":{"type":["string","null"]},"consultation_status":{"anyOf":[{"type":"string","enum":["planned","open","closed","outcome-published","withdrawn","other"]},{"type":"null"}]},"consultation_status_native":{"description":"The source's own status.","type":["string","null"]},"subjects":{"type":"array","items":{"type":"string"}},"document_counts":{"type":"array","items":{"$ref":"#/components/schemas/DocumentTypeCount"}},"response_count":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Response documents listed by the source; null when it lists none (not the same as no responses)."},"responses_combined":{"type":"boolean","description":"The responses are one combined document."},"bill":{"anyOf":[{"$ref":"#/components/schemas/Bill"},{"type":"null"}]},"parliament_response_files":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/FileId"}},{"type":"null"}],"description":"The bill's appendix files with responses and memo in parliament."},"description":{"type":["string","null"]},"archived_on":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"duplicate_of":{"anyOf":[{"type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"title":{"type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","title","source_url"],"additionalProperties":false},{"type":"null"}],"description":"The copy with the documents, when the source lists the consultation twice."}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","consultation_type","consultation_type_label","deadline","appeal_deadline","status","status_label","consultation_status","consultation_status_native","subjects","document_counts","response_count","responses_combined","bill","parliament_response_files","description","archived_on","duplicate_of"],"additionalProperties":false},"GetConsultationResponse":{"$id":"#/components/schemas/GetConsultationResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/ConsultationDetailItem"},"message":{"type":["string","null"]},"coverage":{"$ref":"#/components/schemas/Coverage"},"quota":{"$ref":"#/components/schemas/Quota"},"documents":{"type":"array","items":{"$ref":"#/components/schemas/DocumentRef"},"description":"Letter, drafts, list, responses and memo in that order (a local hearing: its page and files)."},"responses":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/ConsultationResponse"}},{"type":"null"}],"description":"Null where the source lists no responses."},"invited":{"anyOf":[{"$ref":"#/components/schemas/Invited"},{"type":"null"}],"description":"From the consultation list; null until it is read."},"changes_after_consultation":{"type":"array","items":{"$ref":"#/components/schemas/ChangeAfterConsultation"}},"no_changes":{"description":"True: the memo says nothing was changed; null: no memo read yet (do not say nothing changed).","type":["boolean","null"]},"memo_count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["item","message","documents","responses","invited","changes_after_consultation","no_changes","memo_count"],"additionalProperties":false},"CoverageUnitEntry":{"$id":"#/components/schemas/CoverageUnitEntry","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/JurisdictionId"}],"description":"The unit: a jurisdiction (municipality, region) or an organization (ministry, party)."},"name":{"type":"string"},"coverage":{"type":"string","enum":["full","partial","none"]},"documents":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"latest_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]}},"required":["id","name","coverage","documents","latest_date"],"additionalProperties":false},"SourceCoverageDetails":{"$id":"#/components/schemas/SourceCoverageDetails","type":"object","properties":{"update_interval_hours":{"description":"The freshness promise of the source's manifest.","type":["number","null"]},"hours_since_sync":{"type":["number","null"]},"sync_errors":{"type":"integer","minimum":0,"maximum":9007199254740991},"counts_computed_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"reconciliation":{"anyOf":[{"type":"object","properties":{"day":{"$ref":"#/components/schemas/Day"},"expected":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"mirrored":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"missing":{"type":"integer","minimum":0,"maximum":9007199254740991},"withdrawn":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["day","expected","mirrored","missing","withdrawn"],"additionalProperties":false},{"type":"null"}]},"unit_list":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/CoverageUnitEntry"}},{"type":"null"}]}},"required":["update_interval_hours","hours_since_sync","sync_errors","counts_computed_at","reconciliation","unit_list"],"additionalProperties":false},"SourceCoverage":{"$id":"#/components/schemas/SourceCoverage","type":"object","properties":{"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string"},"covers":{"type":"string","description":"Localised: what the source covers (manifest)."},"documents":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Files with text, searchable."},"records":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Matters, meetings, items, articles, … (searchable too)."},"earliest_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"latest_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"last_fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"last_synced_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"current":{"description":"Synced within twice the promised interval.","type":["boolean","null"]},"text_missing":{"anyOf":[{"type":"object","properties":{"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"pending":{"type":"integer","minimum":0,"maximum":9007199254740991},"pending_from":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"pending_to":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"blocked":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["total","pending","pending_from","pending_to","blocked","failed"],"additionalProperties":false},{"type":"null"}]},"units":{"anyOf":[{"type":"object","properties":{"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"full":{"type":"integer","minimum":0,"maximum":9007199254740991},"partial":{"type":"integer","minimum":0,"maximum":9007199254740991},"none":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["total","full","partial","none"],"additionalProperties":false},{"type":"null"}],"description":"Null until the coverage task has written the source's roster."},"known_gaps":{"type":"array","items":{"type":"string"},"description":"Localised, short and factual (catalogue `api.coverage.gaps.*`)."},"details":{"description":"With `details=true`.","$ref":"#/components/schemas/SourceCoverageDetails"}},"required":["source","source_name","covers","documents","records","earliest_date","latest_date","last_fetched_at","last_synced_at","current","text_missing","units","known_gaps"],"additionalProperties":false},"CoverageResponse":{"$id":"#/components/schemas/CoverageResponse","type":"object","properties":{"sources":{"type":"array","items":{"$ref":"#/components/schemas/SourceCoverage"}},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["sources","message"],"additionalProperties":false},"AttestationResponse":{"$id":"#/components/schemas/AttestationResponse","type":"object","properties":{"attestation_id":{"type":"string","pattern":"^[0-9A-Za-z]{22}$"},"attestation_url":{"type":"string","maxLength":2048,"format":"uri"},"at":{"allOf":[{"pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"pattern":"[+-]\\d{2}:\\d{2}$"}],"description":"When the answer was given.","$ref":"#/components/schemas/DateTime"},"action":{"type":"string","description":"The operation or MCP tool, as in the organisation's audit log."},"kind":{"type":"string","description":"The audit event kind."},"channel":{"type":"string","enum":["rest","mcp"]},"client":{"description":"The key's or OAuth client's name.","type":["string","null"]},"parameters":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"The validated parameters, as audited."},"result_count":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"result_ids":{"maxItems":100,"type":"array","items":{"type":"string"}},"status":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"coverage":{"description":"The coverage block as it was, recomputed from the same snapshots.","$ref":"#/components/schemas/Coverage"},"unit_list":{"type":"array","items":{"type":"object","properties":{"source":{"$ref":"#/components/schemas/SourceSlug"},"units":{"type":"array","items":{"$ref":"#/components/schemas/CoverageUnitEntry"}}},"required":["source","units"],"additionalProperties":false}},"snapshots":{"type":"array","items":{"type":"object","properties":{"source":{"$ref":"#/components/schemas/SourceSlug"},"computed_at":{"$ref":"#/components/schemas/DateTime"}},"required":["source","computed_at"],"additionalProperties":false},"description":"The coverage snapshots the certificate rests on."},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["attestation_id","attestation_url","at","action","kind","channel","client","parameters","result_count","result_ids","status","coverage","unit_list","snapshots","message"],"additionalProperties":false},"DocumentListItem":{"$id":"#/components/schemas/DocumentListItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"document_status":{"anyOf":[{"type":"string","enum":["draft","provisional","final","distributed","withdrawn","machine","other"]},{"type":"null"}]},"document_status_label":{"type":["string","null"]},"text_available":{"type":"boolean","description":"The text has been read; GET /v2/documents/{id}/pages reads it."},"file_id":{"anyOf":[{"$ref":"#/components/schemas/FileId"},{"type":"null"}]},"question_type":{"anyOf":[{"type":"string","enum":["question","question.written","question.oral","question.committee","consultation-meeting","interpellation"]},{"type":"null"}]},"question_type_label":{"type":["string","null"]},"question_text":{"description":"The question's wording, when the source records it.","type":["string","null"]},"matter":{"anyOf":[{"$ref":"#/components/schemas/MatterRef"},{"type":"null"}],"description":"The document's first matter."},"actors":{"type":"array","items":{"$ref":"#/components/schemas/ActorRef"},"description":"Askers, addressees, ministers (with the holder on the document's date), committees."},"references":{"maxItems":10,"type":"array","items":{"$ref":"#/components/schemas/PageReference"},"description":"The questions, samrådsspørgsmål and bilag the document's text refers to, answers first; empty when nothing was read."}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","document_status","document_status_label","text_available","file_id","question_type","question_type_label","question_text","matter","actors","references"],"additionalProperties":false},"ListDocumentsResponse":{"$id":"#/components/schemas/ListDocumentsResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/DocumentListItem"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"coverage":{"$ref":"#/components/schemas/Coverage"},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","next_cursor","filters","message"],"additionalProperties":false},"Reading":{"$id":"#/components/schemas/Reading","type":"object","properties":{"matter":{"anyOf":[{"$ref":"#/components/schemas/MatterRef"},{"type":"null"}]},"reading":{"description":"As the source names it, e.g. `1. behandling`.","type":["string","null"]},"matter_action_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The reading's own page at the source."}},"required":["matter","reading","matter_action_id","source_url"],"additionalProperties":false},"TranscriptSegment":{"$id":"#/components/schemas/TranscriptSegment","type":"object","properties":{"speech_id":{"$ref":"#/components/schemas/EntityId"},"start":{"type":"string","pattern":"^\\d{2}:\\d{2}:\\d{2}$","description":"Offset into the video."},"start_seconds":{"type":"number","minimum":0},"end_seconds":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"speaker":{"type":"string"},"speaker_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"char_from":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Offsets into page 1 of the text."},"char_to":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"video_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The video at this speaker's start (or its page)."}},"required":["speech_id","start","start_seconds","end_seconds","speaker","speaker_id","char_from","char_to","video_url"],"additionalProperties":false},"Transcript":{"$id":"#/components/schemas/Transcript","type":"object","properties":{"kind":{"type":"string","enum":["official","machine"],"description":"`official`: the parliament's own transcript; `machine`: our transcript of the meeting's video, never an official record."},"edition":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"meeting":{"anyOf":[{"$ref":"#/components/schemas/MeetingRef"},{"type":"null"}]},"video_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]},"embed_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]},"channel":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]}},"required":["id","name"],"additionalProperties":false},{"type":"null"}],"description":"A machine transcript's video channel."},"platform":{"description":"A machine transcript's video platform.","type":["string","null"]},"readings":{"type":"array","items":{"$ref":"#/components/schemas/Reading"}},"segments":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/TranscriptSegment"}},{"type":"null"}],"description":"A machine transcript read with GET /v2/documents/{id}/pages: the speaker turns in the text shown, each with its moment in the video; null otherwise."}},"required":["kind","edition","meeting","video_url","embed_url","channel","platform","readings","segments"],"additionalProperties":false,"description":"For a transcript: official (a plenary's edition, meeting, web-TV and readings) or machine (a meeting video's channel, platform, video and speaker turns)."},"DocumentDetailItem":{"$id":"#/components/schemas/DocumentDetailItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"document_status":{"anyOf":[{"type":"string","enum":["draft","provisional","final","distributed","withdrawn","machine","other"]},{"type":"null"}]},"document_status_label":{"type":["string","null"]},"text_available":{"type":"boolean","description":"The text has been read; GET /v2/documents/{id}/pages reads it."},"file_id":{"anyOf":[{"$ref":"#/components/schemas/FileId"},{"type":"null"}]},"page_count":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Pages with text; null until read."},"files":{"type":"array","items":{"$ref":"#/components/schemas/FileRef"},"description":"Every file of the document (most have one)."},"matters":{"type":"array","items":{"$ref":"#/components/schemas/MatterRef"}},"actors":{"type":"array","items":{"$ref":"#/components/schemas/ActorRef"}},"term":{"anyOf":[{"$ref":"#/components/schemas/TermRef"},{"type":"null"}]},"published_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"transcript":{"anyOf":[{"$ref":"#/components/schemas/Transcript"},{"type":"null"}]},"attributes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"The source's public attributes, namespaced; an allowlist per source."}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","document_status","document_status_label","text_available","file_id","page_count","files","matters","actors","term","published_at","transcript","attributes"],"additionalProperties":false},"GetDocumentResponse":{"$id":"#/components/schemas/GetDocumentResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/DocumentDetailItem"},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["item","message"],"additionalProperties":false},"PageText":{"$id":"#/components/schemas/PageText","type":"object","properties":{"page":{"type":"integer","minimum":1,"maximum":9007199254740991},"text":{"type":"string"},"char_from":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Set when only part of the page is shown."},"char_to":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"char_count":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["page","text","char_from","char_to","char_count"],"additionalProperties":false},"GetDocumentPagesResponse":{"$id":"#/components/schemas/GetDocumentPagesResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/DocumentDetailItem"},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageText"}},"truncated":{"type":"boolean"},"continue_from":{"anyOf":[{"type":"object","properties":{"page":{"type":"integer","minimum":1,"maximum":9007199254740991},"char":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["page","char"],"additionalProperties":false},{"type":"null"}],"description":"Where the next read starts (send as from_page and from_char); always past what was shown; null at the end."},"next_page":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Null inside a page."},"next_char":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Null at a page boundary."},"references":{"type":"array","items":{"$ref":"#/components/schemas/PageReference"},"description":"What the document's text refers to (the whole document, not only the shown pages)."},"summary_status":{"anyOf":[{"type":"string","enum":["ready","pending"]},{"type":"null"}]}},"required":["item","message","pages","truncated","continue_from","next_page","next_char","references","summary_status"],"additionalProperties":false},"DocumentVersion":{"$id":"#/components/schemas/DocumentVersion","type":"object","properties":{"number":{"type":"integer","minimum":1,"maximum":9007199254740991},"seen_from":{"allOf":[{"pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"pattern":"[+-]\\d{2}:\\d{2}$"}],"description":"When the product first held this version (the oldest: when first seen).","$ref":"#/components/schemas/DateTime"},"sha256":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"source_version":{"description":"The source's own version label.","type":["string","null"]},"current":{"type":"boolean"},"change_id":{"description":"The change that brought it, for GET /v2/changes/{id}.","type":["string","null"]},"text_unchanged":{"type":["boolean","null"]},"page_count":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["number","seen_from","sha256","source_version","current","change_id","text_unchanged","page_count"],"additionalProperties":false},"ListDocumentVersionsResponse":{"$id":"#/components/schemas/ListDocumentVersionsResponse","type":"object","properties":{"item":{"type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source"],"additionalProperties":false},"versions":{"type":"array","items":{"$ref":"#/components/schemas/DocumentVersion"},"description":"Newest first."},"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"withdrawn":{"type":"boolean","description":"Withdrawn by the source: only the versions' dates are shown."},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["item","versions","count","withdrawn","message"],"additionalProperties":false},"Dossier":{"$id":"#/components/schemas/Dossier","type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f-]{8,64}$","description":"Id of an object in the organisation's account (a uuid)."},"title":{"type":"string"},"description":{"type":["string","null"]},"archived":{"type":"boolean"},"item_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"new_count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items added since the caller last marked the dossier read, not by the caller."},"created_at":{"$ref":"#/components/schemas/DateTime"},"updated_at":{"$ref":"#/components/schemas/DateTime"}},"required":["id","title","description","archived","item_count","new_count","created_at","updated_at"],"additionalProperties":false},"DossierItem":{"$id":"#/components/schemas/DossierItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"item_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"added_by":{"type":"string","enum":["manual","watch","automatic"],"description":"`watch`: a row from the watches before ADR 0026; nothing writes it any more."},"event":{"description":"Localised: what happened, e.g. `Høringsnotat`, `Referat`.","type":["string","null"]},"via":{"description":"The followed entity id it came from.","type":["string","null"]},"note":{"type":["string","null"]},"pinned":{"type":"boolean"},"added_at":{"$ref":"#/components/schemas/DateTime"}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","item_id","added_by","event","via","note","pinned","added_at"],"additionalProperties":false},"DossierNote":{"$id":"#/components/schemas/DossierNote","type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"text":{"type":"string"},"author":{"type":["string","null"]},"created_at":{"$ref":"#/components/schemas/DateTime"}},"required":["id","text","author","created_at"],"additionalProperties":false},"DossierStatus":{"$id":"#/components/schemas/DossierStatus","type":"object","properties":{"text":{"type":"string","description":"Localised short summary, assembled without a language model."},"updated_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"followed":{"type":"array","items":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"entity_type":{"$ref":"#/components/schemas/EntityType"},"title":{"type":["string","null"]},"status_text":{"type":["string","null"]},"summary":{"type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","entity_type","title","status_text","summary","source_url"],"additionalProperties":false}},"timeline":{"type":"array","items":{"type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"title":{"type":["string","null"]},"date":{"type":["string","null"]},"event":{"type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","title","date","event","source_url"],"additionalProperties":false}}},"required":["text","updated_at","followed","timeline"],"additionalProperties":false,"description":"Assembled on read from public data only; the dossier's own content never leaves."},"DossierListResponse":{"$id":"#/components/schemas/DossierListResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Dossier"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"plan_limit":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The plan's limit; null: no limit."},"used":{"type":"integer","minimum":0,"maximum":9007199254740991},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","plan_limit","used","message"],"additionalProperties":false},"DossierDraft":{"$id":"#/components/schemas/DossierDraft","type":"object","properties":{"title":{"type":"string"},"description":{"type":["string","null"]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"title":{"type":["string","null"]}},"required":["id","title"],"additionalProperties":false}}},"required":["title","description","items"],"additionalProperties":false},"DossierPreviewResponse":{"$id":"#/components/schemas/DossierPreviewResponse","type":"object","properties":{"preview":{"type":"boolean","const":true},"created":{"type":"boolean","const":false},"item":{"$ref":"#/components/schemas/DossierDraft"},"plan_limit":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The plan's limit; null: no limit."},"used":{"type":"integer","minimum":0,"maximum":9007199254740991},"message":{"type":"string","description":"Localised: what would be created, for the user to confirm."},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["preview","created","item","plan_limit","used","message"],"additionalProperties":false},"DossierResponse":{"$id":"#/components/schemas/DossierResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/Dossier"},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["item","message"],"additionalProperties":false},"DossierDetailResponse":{"$id":"#/components/schemas/DossierDetailResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/Dossier"},"status":{"$ref":"#/components/schemas/DossierStatus"},"notes":{"type":"array","items":{"$ref":"#/components/schemas/DossierNote"}},"type_counts":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Items per entity type."},"items":{"maxItems":50,"type":"array","items":{"$ref":"#/components/schemas/DossierItem"},"description":"The 50 newest items."},"next_cursor":{"description":"For GET …/items.","type":["string","null"]},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["item","status","notes","type_counts","items","next_cursor","message"],"additionalProperties":false},"DossierItemsResponse":{"$id":"#/components/schemas/DossierItemsResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/DossierItem"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","next_cursor","filters","message"],"additionalProperties":false},"DossierItemResponse":{"$id":"#/components/schemas/DossierItemResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/DossierItem"},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["item","message"],"additionalProperties":false},"DossierNoteResponse":{"$id":"#/components/schemas/DossierNoteResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/DossierNote"},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["item","message"],"additionalProperties":false},"DossierUpdatesResponse":{"$id":"#/components/schemas/DossierUpdatesResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/DossierItem"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"},"since":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"The caller's read mark; null: never marked."}},"required":["items","count","next_cursor","filters","message","since"],"additionalProperties":false},"DossierReadResponse":{"$id":"#/components/schemas/DossierReadResponse","type":"object","properties":{"read_at":{"$ref":"#/components/schemas/DateTime"},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["read_at","message"],"additionalProperties":false},"ExportJob":{"$id":"#/components/schemas/ExportJob","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"operation":{"type":"string","pattern":"^[a-z][A-Za-z0-9]{1,60}$","description":"The operationId of an exportable /v2 list route."},"description":{"type":"string","description":"Localised: the list and its filters."},"parameters":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string","maxLength":500},{"type":"number"},{"type":"boolean"},{"maxItems":50,"type":"array","items":{"anyOf":[{"type":"string","maxLength":200},{"type":"number"}]}}]}},"format":{"type":"string","enum":["csv","xlsx"]},"status":{"type":"string","enum":["queued","running","done","failed","expired"]},"status_label":{"type":"string"},"rows":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"expected_rows":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"expected_rows_exact":{"type":"boolean"},"max_rows":{"type":"integer","minimum":1,"maximum":9007199254740991},"truncated":{"type":"boolean","description":"Stopped at the route's cursor depth or `max_rows`."},"bytes":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"lookups":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Lookups charged to the plan."},"message":{"description":"Localised: why it failed or stopped early.","type":["string","null"]},"created_at":{"$ref":"#/components/schemas/DateTime"},"finished_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"expires_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"download_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The customer portal's page for the file, for a person."},"download_path":{"description":"The API path of the file (GET /v2/exports/{id}/download), once done.","type":["string","null"]}},"required":["id","operation","description","parameters","format","status","status_label","rows","expected_rows","expected_rows_exact","max_rows","truncated","bytes","lookups","message","created_at","finished_at","expires_at","download_url","download_path"],"additionalProperties":false},"ExportListResponse":{"$id":"#/components/schemas/ExportListResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ExportJob"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","next_cursor","filters","message"],"additionalProperties":false},"ExportPreviewResponse":{"$id":"#/components/schemas/ExportPreviewResponse","type":"object","properties":{"created":{"type":"boolean","const":false},"preview":{"type":"boolean","description":"True when asked for; false when confirmation is required."},"expected_rows":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"expected_rows_exact":{"type":"boolean"},"lookups":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Estimated lookups."},"lookups_max":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"At most this many."},"requires_confirmation":{"type":"boolean"},"message":{"type":"string","description":"Localised, for the user to confirm."},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["created","preview","expected_rows","expected_rows_exact","lookups","lookups_max","requires_confirmation","message"],"additionalProperties":false},"ExportCreatedResponse":{"$id":"#/components/schemas/ExportCreatedResponse","type":"object","properties":{"created":{"type":"boolean","const":true},"item":{"$ref":"#/components/schemas/ExportJob"},"lookups":{"type":"integer","minimum":0,"maximum":9007199254740991},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["created","item","lookups","message"],"additionalProperties":false},"ExportResponse":{"$id":"#/components/schemas/ExportResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/ExportJob"},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["item","message"],"additionalProperties":false},"SentFeedback":{"$id":"#/components/schemas/SentFeedback","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The feedback's id."},"category":{"type":"string","enum":["works_well","not_working","missing_feature","source_request","other"]},"created_at":{"$ref":"#/components/schemas/DateTime"}},"required":["id","category","created_at"],"additionalProperties":false},"SendFeedbackResponse":{"$id":"#/components/schemas/SendFeedbackResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/SentFeedback"},"message":{"description":"Localised thanks, to pass on to the user.","type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["item","message"],"additionalProperties":false},"LegalActItem":{"$id":"#/components/schemas/LegalActItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"act_type":{"type":"string","enum":["act","act.consolidated","regulation","circular","guidance","treaty","directive","regulation.supranational","decision","plan","plan.local","plan.amendment","other"]},"act_type_label":{"type":"string"},"act_type_native":{"type":["string","null"]},"act_status":{"type":"string","enum":["in-force","repealed","not-yet-in-force","proposed","other"]},"act_status_label":{"type":"string"},"number":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"year":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"popular_title":{"type":["string","null"]},"issuer":{"type":["string","null"]},"issuer_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"in_force_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"eli":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The ELI address, when the act has one."},"file_id":{"anyOf":[{"$ref":"#/components/schemas/FileId"},{"type":"null"}],"description":"The act's text, for GET /v2/documents/{id}/pages."}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","act_type","act_type_label","act_type_native","act_status","act_status_label","number","year","popular_title","issuer","issuer_id","in_force_date","eli","file_id"],"additionalProperties":false},"LegislationResponse":{"$id":"#/components/schemas/LegislationResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/LegalActItem"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"interpretation":{"description":"Localised: how the query was read (dropped words, broadening, semantic hits).","type":["string","null"]},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","next_cursor","filters","interpretation","message"],"additionalProperties":false},"LifecycleLink":{"$id":"#/components/schemas/LifecycleLink","type":"object","properties":{"relation_type":{"type":"string","enum":["enacted-as","consults-on","amends","based-on","transposes","related","replaces","split-from","introduced-under","debated-with","answers","mentions","duplicate-of","announces","attached-to","eu-proposal","document-of","change-proposed","change-supported","parliamentary-group","other"]},"method":{"type":"string","description":"How the link was found (`upstream`, `title`, `reference`, …)."},"confidence":{"type":"string","enum":["certain","high","medium","low"]},"from":{"type":"string","description":"The id of the step the link starts from."}},"required":["relation_type","method","confidence","from"],"additionalProperties":false,"description":"How a step is tied to the timeline, and how certain that is."},"LifecycleStep":{"$id":"#/components/schemas/LifecycleStep","type":"object","properties":{"id":{"type":"string"},"step":{"type":"string","enum":["eu_proposal","eu_memo","eu_act_adopted","bill","reading","consultation","act","amending_act","consolidated_act","regulation","circular","guidance","other_act","local_mention"]},"step_label":{"type":"string"},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string"},"authority":{"type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]},"link":{"anyOf":[{"$ref":"#/components/schemas/LifecycleLink"},{"type":"null"}]}},"required":["id","step","step_label","title","date","source","source_name","authority","source_url","link"],"additionalProperties":false},"Omitted":{"$id":"#/components/schemas/Omitted","type":"object","properties":{"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string"},"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"message":{"type":"string"}},"required":["source","source_name","count","message"],"additionalProperties":false},"LifecycleResponse":{"$id":"#/components/schemas/LifecycleResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/Item"},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"},"timeline":{"type":"array","items":{"$ref":"#/components/schemas/LifecycleStep"},"description":"Oldest first."},"omitted":{"type":"array","items":{"$ref":"#/components/schemas/Omitted"},"description":"Steps from sources the key may not read: left out and counted here, never a 403."}},"required":["item","message","timeline","omitted"],"additionalProperties":false},"TranspositionItem":{"$id":"#/components/schemas/TranspositionItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"celex":{"type":"string"},"transposed":{"type":"boolean"},"transposed_by":{"type":"array","items":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"title":{"type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","title","source_url"],"additionalProperties":false}},"bills":{"type":"array","items":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"reference":{"type":["string","null"]},"title":{"type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","reference","title","source_url"],"additionalProperties":false}},"eu_proposal":{"anyOf":[{"type":"object","properties":{"reference":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["reference","source_url"],"additionalProperties":false},{"type":"null"}]},"transposition_deadline":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"deadline_missing":{"type":"boolean","description":"True while the deadline is not in the data."}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","celex","transposed","transposed_by","bills","eu_proposal","transposition_deadline","deadline_missing"],"additionalProperties":false},"EuTranspositionResponse":{"$id":"#/components/schemas/EuTranspositionResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/TranspositionItem"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"interpretation":{"description":"Localised: how the query was read (dropped words, broadening, semantic hits).","type":["string","null"]},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"},"omitted":{"type":"array","items":{"$ref":"#/components/schemas/Omitted"}},"explanation":{"type":"string"}},"required":["items","count","next_cursor","filters","interpretation","message","omitted","explanation"],"additionalProperties":false},"ProgrammeForecast":{"$id":"#/components/schemas/ProgrammeForecast","type":"object","properties":{"next_step":{"type":"string"},"expected_date":{"$ref":"#/components/schemas/Day"},"interval":{"type":"object","properties":{"from":{"$ref":"#/components/schemas/Day"},"to":{"$ref":"#/components/schemas/Day"}},"required":["from","to"],"additionalProperties":false,"description":"25–75 % of earlier bills."},"basis_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"basis":{"type":"string"},"latest_step":{"type":["string","null"]},"latest_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"passage":{"anyOf":[{"type":"object","properties":{"expected_date":{"$ref":"#/components/schemas/Day"},"interval":{"type":"object","properties":{"from":{"$ref":"#/components/schemas/Day"},"to":{"$ref":"#/components/schemas/Day"}},"required":["from","to"],"additionalProperties":false},"basis_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"basis":{"type":"string"}},"required":["expected_date","interval","basis_count","basis"],"additionalProperties":false},{"type":"null"}]},"message":{"type":"string","description":"Localised: this is an estimate, and what it rests on."}},"required":["next_step","expected_date","interval","basis_count","basis","latest_step","latest_date","passage","message"],"additionalProperties":false,"description":"For an open bill: when its next step and its passage can be expected, from earlier bills."},"ProgrammeListItem":{"$id":"#/components/schemas/ProgrammeListItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"term":{"$ref":"#/components/schemas/TermRef"},"in_programme":{"type":"boolean"},"kind":{"type":"string","enum":["bill","bill.budget","resolution","motion","motion.procedural","appropriation-request","question","question.written","question.oral","question.committee","interpellation","consultation-meeting","general-committee-matter","report","eu-matter","debate","regulation","election-appointment","petition","council-case","council-motion","council-question","audit","procurement","other"]},"kind_label":{"type":"string"},"minister":{"type":["string","null"]},"description":{"type":["string","null"]},"expected_introduction":{"anyOf":[{"type":"object","properties":{"text":{"type":"string","description":"As the programme writes it, e.g. `Okt I`."},"month":{"anyOf":[{"type":"integer","minimum":1,"maximum":12},{"type":"null"}]},"half":{"anyOf":[{"anyOf":[{"type":"number","const":1},{"type":"number","const":2}]},{"type":"null"}]},"latest":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]}},"required":["text","month","half","latest"],"additionalProperties":false},{"type":"null"}]},"programme_status":{"type":"string","enum":["not_introduced","introduced","passed","rejected","lapsed","not_in_programme"]},"programme_status_label":{"type":"string"},"delayed":{"type":"boolean"},"reintroduction_of":{"type":["string","null"]},"matter":{"anyOf":[{"type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"reference":{"type":["string","null"]},"title":{"type":["string","null"]},"matter_status":{"type":"string","enum":["pending","in-committee","reported","passed","passed-final","enacted","rejected","withdrawn","lapsed","answered","concluded","referred-back","in-mediation","other"]},"matter_status_label":{"type":"string"},"term":{"type":["string","null"]},"introduced_on":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","reference","title","matter_status","matter_status_label","term","introduced_on","source_url"],"additionalProperties":false},{"type":"null"}]},"match":{"anyOf":[{"type":"object","properties":{"method":{"type":"string","enum":["title","manual"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["method","confidence"],"additionalProperties":false},{"type":"null"}]},"forecast":{"anyOf":[{"$ref":"#/components/schemas/ProgrammeForecast"},{"type":"null"}]}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","term","in_programme","kind","kind_label","minister","description","expected_introduction","programme_status","programme_status_label","delayed","reintroduction_of","matter","match","forecast"],"additionalProperties":false},"LegislativeProgrammeResponse":{"$id":"#/components/schemas/LegislativeProgrammeResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ProgrammeListItem"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"},"per_ministry":{"type":"array","items":{"type":"object","properties":{"ministry":{"type":"string"},"announced":{"type":"integer","minimum":0,"maximum":9007199254740991},"introduced":{"type":"integer","minimum":0,"maximum":9007199254740991},"passed":{"type":"integer","minimum":0,"maximum":9007199254740991},"not_introduced":{"type":"integer","minimum":0,"maximum":9007199254740991},"delayed":{"type":"integer","minimum":0,"maximum":9007199254740991},"not_in_programme":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["ministry","announced","introduced","passed","not_introduced","delayed","not_in_programme"],"additionalProperties":false}},"explanation":{"type":"string"}},"required":["items","count","next_cursor","filters","message","per_ministry","explanation"],"additionalProperties":false},"CompareRow":{"$id":"#/components/schemas/CompareRow","type":"object","properties":{"id":{"$ref":"#/components/schemas/JurisdictionId"},"authority_id":{"$ref":"#/components/schemas/EntityId"},"name":{"type":"string"},"population":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"status":{"type":"string","enum":["treated","not_found","not_covered"]},"status_label":{"type":"string"},"status_text":{"type":"string","description":"Localised: why, or the caveat."},"item_count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"One per meeting and case."},"meeting_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"first_date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"latest_date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"latest_committee":{"type":["string","null"]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"committee":{"anyOf":[{"$ref":"#/components/schemas/OrganizationRef"},{"type":"null"}]},"minutes":{"type":"boolean"},"decision":{"description":"Excerpt, from minutes only.","type":["string","null"]},"meeting_id":{"$ref":"#/components/schemas/EntityId"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","title","date","committee","minutes","decision","meeting_id","source_url"],"additionalProperties":false}}},"required":["id","authority_id","name","population","status","status_label","status_text","item_count","meeting_count","first_date","latest_date","latest_committee","items"],"additionalProperties":false,"description":"One row per authority, hit or not, largest first, fixed keys (exportable as a table)."},"CompareTable":{"$id":"#/components/schemas/CompareTable","type":"object","properties":{"view":{"type":"string","const":"table"},"items":{"type":"array","items":{"$ref":"#/components/schemas/CompareRow"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"totals":{"type":"object","properties":{"authorities":{"type":"integer","minimum":0,"maximum":9007199254740991},"treated":{"type":"integer","minimum":0,"maximum":9007199254740991},"not_found":{"type":"integer","minimum":0,"maximum":9007199254740991},"not_covered":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["authorities","treated","not_found","not_covered"],"additionalProperties":false},"filters":{"$ref":"#/components/schemas/Filters"},"next_cursor":{"type":"null","description":"Always null: every row comes in one answer."},"message":{"type":"string","description":"Localised: what the three states mean; repeat it."},"definitions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["view","items","count","totals","filters","next_cursor","message","definitions"],"additionalProperties":false},"CompareMonth":{"$id":"#/components/schemas/CompareMonth","type":"object","properties":{"month":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"new":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Authorities whose first match falls in the month."},"total":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Authorities with a match so far."},"authorities":{"type":"array","items":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/JurisdictionId"},"name":{"type":"string"},"first_date":{"$ref":"#/components/schemas/DayOrDateTime"},"at_archive_start":{"type":"boolean","description":"Within 365 days of the authority's first mirrored meeting."}},"required":["id","name","first_date","at_archive_start"],"additionalProperties":false}}},"required":["month","new","total","authorities"],"additionalProperties":false},"CompareTimeline":{"$id":"#/components/schemas/CompareTimeline","type":"object","properties":{"view":{"type":"string","const":"timeline"},"items":{"type":"array","items":{"$ref":"#/components/schemas/CompareMonth"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"totals":{"type":"object","properties":{"authorities":{"type":"integer","minimum":0,"maximum":9007199254740991},"treated":{"type":"integer","minimum":0,"maximum":9007199254740991},"not_found":{"type":"integer","minimum":0,"maximum":9007199254740991},"not_covered":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["authorities","treated","not_found","not_covered"],"additionalProperties":false},"not_covered":{"type":"array","items":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/JurisdictionId"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"filters":{"$ref":"#/components/schemas/Filters"},"next_cursor":{"type":"null"},"message":{"type":"string"},"definitions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["view","items","count","totals","not_covered","filters","next_cursor","message","definitions"],"additionalProperties":false},"CompareLocalAuthoritiesResponse":{"$id":"#/components/schemas/CompareLocalAuthoritiesResponse","oneOf":[{"$ref":"#/components/schemas/CompareTable"},{"$ref":"#/components/schemas/CompareTimeline"}]},"TransparencyRow":{"$id":"#/components/schemas/TransparencyRow","type":"object","properties":{"id":{"$ref":"#/components/schemas/JurisdictionId"},"authority_id":{"$ref":"#/components/schemas/EntityId"},"name":{"type":"string"},"population":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"rank":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Competition rank among complete rows with a value; null when not ranked."},"complete":{"type":"boolean"},"missing":{"type":"array","items":{"type":"string"},"description":"Localised reasons the row is incomplete."},"meetings":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"minutes_items":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"closed_items_share_pct":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"pdf_only_share_pct":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"without_decision_share_pct":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"minutes_median_days":{"type":["number","null"]},"consultation_median_days":{"type":["number","null"]},"samples":{"type":"object","properties":{"minutes_items":{"type":"integer","minimum":0,"maximum":9007199254740991},"open_items_assessed":{"type":"integer","minimum":0,"maximum":9007199254740991},"minutes_with_publication_date":{"type":"integer","minimum":0,"maximum":9007199254740991},"consultations":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["minutes_items","open_items_assessed","minutes_with_publication_date","consultations"],"additionalProperties":false}},"required":["id","authority_id","name","population","rank","complete","missing","meetings","minutes_items","closed_items_share_pct","pdf_only_share_pct","without_decision_share_pct","minutes_median_days","consultation_median_days","samples"],"additionalProperties":false},"LocalAuthorityTransparencyResponse":{"$id":"#/components/schemas/LocalAuthorityTransparencyResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/TransparencyRow"},"description":"Ranked rows first, incomplete rows last."},"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"period":{"type":"object","properties":{"period":{"type":"string"},"kind":{"type":"string","enum":["rolling","year","quarter"]},"from_date":{"$ref":"#/components/schemas/Day"},"to_date":{"$ref":"#/components/schemas/Day"},"computed_at":{"$ref":"#/components/schemas/DateTime"}},"required":["period","kind","from_date","to_date","computed_at"],"additionalProperties":false},"periods":{"type":"array","items":{"type":"string"},"description":"The periods with figures."},"filters":{"$ref":"#/components/schemas/Filters"},"next_cursor":{"type":"null"},"message":{"type":["string","null"]},"definitions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","period","periods","filters","next_cursor","message","definitions"],"additionalProperties":false},"MailInlineAttachment":{"$id":"#/components/schemas/MailInlineAttachment","type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[^/\\\\]+$","description":"The file's name as the recipient sees it; no path separators."},"content":{"type":"string","description":"The file's content, as text (`utf8`) or base64. At most 2 MB decoded across all inline attachments (else 413 `mail_too_large`)."},"encoding":{"default":"utf8","type":"string","enum":["utf8","base64"]},"content_type":{"description":"A hint only: the type is decided from the bytes, and a type outside the allowlist is 415 `attachment_type`.","type":"string","maxLength":200,"pattern":"^[a-z0-9][a-z0-9!#$&^_.+-]*\\/[a-z0-9][a-z0-9!#$&^_.+-]*$"}},"required":["filename","content","encoding"],"additionalProperties":false,"description":"A file the assistant made itself."},"MailDocumentAttachment":{"$id":"#/components/schemas/MailDocumentAttachment","type":"object","properties":{"document_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}],"description":"A document, publication or legal act id, or a file id (`dk:archive:file:7`), read under the caller's source rules like GET /v2/documents/{id}; its original file name and type are kept."}},"required":["document_id"],"additionalProperties":false,"description":"A stored document, attached from the archive instead of copied into the mail."},"MailAttachment":{"$id":"#/components/schemas/MailAttachment","anyOf":[{"$ref":"#/components/schemas/MailInlineAttachment"},{"$ref":"#/components/schemas/MailDocumentAttachment"}]},"SentMail":{"$id":"#/components/schemas/SentMail","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The mail's id in the user's mail log."},"sent_to":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$","description":"The user's verified address, which the mail went to."},"sent_at":{"$ref":"#/components/schemas/DateTime"},"status":{"type":"string","enum":["accepted"],"description":"Mailgun accepted it; delivery is reported to the user in the portal."}},"required":["id","sent_to","sent_at","status"],"additionalProperties":false},"SendMailResponse":{"$id":"#/components/schemas/SendMailResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/SentMail"},"message":{"description":"Localised, e.g. where the mail went.","type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["item","message"],"additionalProperties":false},"MailTemplate":{"$id":"#/components/schemas/MailTemplate","type":"object","properties":{"html":{"type":"string","description":"The whole mail: the frame with `{{subject}}`, `{{title}}` and `{{date}}`, the marker `<!-- blocks -->` where the blocks go, and the footer."},"placeholders":{"type":"array","items":{"type":"string","pattern":"^[a-z_]+$"},"description":"The `{{name}}` placeholders in the HTML, in order of first use."},"blocks":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","enum":["highlights","section","subheading","bullets","paragraph","item","table","note","button","divider"]},"description":{"type":"string","description":"Localised: what the block is for and what goes in it."},"html":{"type":"string","description":"One `<tr>` of the frame's column, with placeholders."},"placeholders":{"type":"array","items":{"type":"string","pattern":"^[a-z_]+$"},"description":"The `{{name}}` placeholders in the HTML, in order of first use."}},"required":["name","description","html","placeholders"],"additionalProperties":false},"description":"The pieces of the mail's body, used as often and in the order the content needs."},"parts":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","enum":["bullet"]},"description":{"type":"string","description":"Localised: where the part goes and what goes in it."},"html":{"type":"string","description":"HTML that goes inside a block (a bullet in `{{bullets}}`)."},"placeholders":{"type":"array","items":{"type":"string","pattern":"^[a-z_]+$"},"description":"The `{{name}}` placeholders in the HTML, in order of first use."}},"required":["name","description","html","placeholders"],"additionalProperties":false},"description":"Pieces that go inside blocks."},"styles":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","enum":["link","strong","muted","mono","tag","table_head","table_cell"]},"description":{"type":"string","description":"Localised: which element the style is for."},"style":{"type":"string","description":"The value of a `style` attribute."}},"required":["name","description","style"],"additionalProperties":false},"description":"Inline styles for HTML of the assistant's own inside a block."},"instructions":{"type":"string","description":"Localised: how to fill in the template and send it."}},"required":["html","placeholders","blocks","parts","styles","instructions"],"additionalProperties":false},"GetMailTemplateResponse":{"$id":"#/components/schemas/GetMailTemplateResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/MailTemplate"},"message":{"type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["item","message"],"additionalProperties":false},"MatterItem":{"$id":"#/components/schemas/MatterItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"matter_type":{"type":"string","enum":["bill","bill.budget","resolution","motion","motion.procedural","appropriation-request","question","question.written","question.oral","question.committee","interpellation","consultation-meeting","general-committee-matter","report","eu-matter","debate","regulation","election-appointment","petition","council-case","council-motion","council-question","audit","procurement","other"]},"matter_type_label":{"type":"string"},"matter_type_native":{"type":["string","null"]},"matter_status":{"anyOf":[{"type":"string","enum":["pending","in-committee","reported","passed","passed-final","enacted","rejected","withdrawn","lapsed","answered","concluded","referred-back","in-mediation","other"]},{"type":"null"}]},"matter_status_label":{"type":["string","null"]},"matter_status_native":{"description":"The source's own status, e.g. `Vedtaget`.","type":["string","null"]},"term":{"anyOf":[{"$ref":"#/components/schemas/TermRef"},{"type":"null"}]},"source_url_note":{"description":"Localised note on `source_url` when the source needs one; null when the link is the page itself or there is no page.","type":["string","null"]},"oversight_assessment":{"anyOf":[{"type":"object","properties":{"criticism":{"anyOf":[{"type":"string","enum":["sharpest-criticism","sharp-criticism","criticism","reprimand"]},{"type":"null"}],"description":"The step of the oversight body's criticism scale its release uses."},"assessment":{"anyOf":[{"type":"string","enum":["entirely-unacceptable","unacceptable","deeply-worrying","very-unsatisfactory","unsatisfactory","worrying","not-entirely-satisfactory","satisfactory"]},{"type":"null"}],"description":"The most severe assessment word its release uses."},"phrases":{"type":"array","items":{"type":"string"},"description":"The words as the release writes them."},"date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The release the verdict was read from."},"confidence":{"anyOf":[{"type":"string","enum":["certain","high","medium","low"]},{"type":"null"}],"description":"How sure the link between the release and the matter is."}},"required":["criticism","assessment","phrases","date","source_url","confidence"],"additionalProperties":false},{"type":"null"}],"description":"An audit matter's verdict from the parliamentary oversight body (Denmark: Statsrevisorerne's press release on the report); null for other matters."}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","matter_type","matter_type_label","matter_type_native","matter_status","matter_status_label","matter_status_native","term","source_url_note","oversight_assessment"],"additionalProperties":false},"ListMattersResponse":{"$id":"#/components/schemas/ListMattersResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/MatterItem"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"interpretation":{"description":"Localised: how the query was read (dropped words, broadening, semantic hits).","type":["string","null"]},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"coverage":{"$ref":"#/components/schemas/Coverage"},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","next_cursor","filters","interpretation","message"],"additionalProperties":false},"MatterAction":{"$id":"#/components/schemas/MatterAction","type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"title":{"type":["string","null"]},"action_types":{"type":"array","items":{"type":"string","enum":["filing","introduction","referral-committee","committee-consideration","reading-1","reading-2","reading-3","committee-report","amendment-introduction","amendment-passage","amendment-failure","passage","failure","withdrawal","hearing-held","committee-question-asked","question-asked","question-answered","deadline","lapse","second-chamber-receipt","second-chamber-passage","second-chamber-consent","second-chamber-objection","mediation-committee","executive-signature","promulgation","entry-into-force","council-treatment","council-decision","consultation-opened","consultation-closed","audit-report-submitted","remarks-issued","ministerial-response","follow-up","other"]}},"action_type_labels":{"type":"array","items":{"type":"string"}},"status_native":{"type":["string","null"]},"meeting_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"agenda_item_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]}},"required":["id","date","title","action_types","action_type_labels","status_native","meeting_id","agenda_item_id"],"additionalProperties":false},"MatterVote":{"$id":"#/components/schemas/MatterVote","type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}],"description":"When the vote was registered; the day alone when the time is unknown."},"passed":{"type":["boolean","null"]},"conclusion":{"type":["string","null"]},"matter_action_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"counts":{"anyOf":[{"type":"object","properties":{"yes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"no":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"abstain":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"absent":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["yes","no","abstain","absent"],"additionalProperties":false},{"type":"null"}]}},"required":["id","date","passed","conclusion","matter_action_id","counts"],"additionalProperties":false},"Debate":{"$id":"#/components/schemas/Debate","type":"object","properties":{"reading":{"description":"As the source names it, e.g. `1. behandling`.","type":["string","null"]},"matter_action_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"date":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"The meeting's start."},"meeting":{"anyOf":[{"$ref":"#/components/schemas/MeetingRef"},{"type":"null"}]},"document_status":{"anyOf":[{"type":"string","enum":["draft","provisional","final","distributed","withdrawn","machine","other"]},{"type":"null"}]},"document_status_label":{"type":["string","null"]},"edition":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The reading's page at the source."},"transcript_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]},"video_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]},"start_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"end_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"text_available":{"type":"boolean"},"document_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}],"description":"The transcript, for GET /v2/documents/{id}/pages."},"page":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}]},"char_from":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"char_to":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["reading","matter_action_id","date","meeting","document_status","document_status_label","edition","source_url","transcript_url","video_url","start_at","end_at","text_available","document_id","page","char_from","char_to"],"additionalProperties":false,"description":"A plenary debate of the matter, from the transcripts, oldest first."},"MatterConsultation":{"$id":"#/components/schemas/MatterConsultation","type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"title":{"type":["string","null"]},"authority":{"type":["string","null"]},"deadline":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]},"link_method":{"type":"string","description":"How the consultation was tied to the matter (`description`, `title`, `relation`)."}},"required":["id","title","authority","deadline","date","source_url","link_method"],"additionalProperties":false},"MatterDocument":{"$id":"#/components/schemas/MatterDocument","type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"document_status":{"anyOf":[{"type":"string","enum":["draft","provisional","final","distributed","withdrawn","machine","other"]},{"type":"null"}]},"document_status_label":{"type":["string","null"]},"authority":{"description":"Set when another authority than the matter's stands behind it.","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]},"file_id":{"type":["string","null"]},"files":{"type":"array","items":{"type":"object","properties":{"file_id":{"type":"string"},"title":{"type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["file_id","title","source_url"],"additionalProperties":false}},"text_available":{"type":"boolean"},"question_text":{"type":["string","null"]},"actors":{"type":"array","items":{"$ref":"#/components/schemas/ActorRef"}},"references":{"maxItems":10,"type":"array","items":{"$ref":"#/components/schemas/PageReference"},"description":"The questions, samrådsspørgsmål and bilag the document's text refers to, answers first; empty when nothing was read."},"from_parent":{"type":"boolean","description":"A split bill's part: the document is shared with the bill it was split from."}},"required":["id","title","date","document_type","document_type_label","document_type_native","document_status","document_status_label","authority","source_url","file_id","files","text_available","question_text","actors","references","from_parent"],"additionalProperties":false},"ProgrammeItem":{"$id":"#/components/schemas/ProgrammeItem","type":"object","properties":{"term":{"anyOf":[{"$ref":"#/components/schemas/TermRef"},{"type":"null"}]},"in_programme":{"type":"boolean","description":"False: introduced without being in the programme."},"title":{"type":["string","null"]},"responsible_minister":{"type":["string","null"]},"expected_introduction":{"anyOf":[{"type":"object","properties":{"text":{"type":"string","description":"As the programme writes it, e.g. `Okt I`."},"month":{"anyOf":[{"type":"integer","minimum":1,"maximum":12},{"type":"null"}]},"half":{"anyOf":[{"type":"string","enum":["first","second"]},{"type":"null"}]},"latest":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]}},"required":["text","month","half","latest"],"additionalProperties":false},{"type":"null"}]},"status":{"type":"string","enum":["not_introduced","introduced","passed","rejected","lapsed","not_in_programme"]},"delayed":{"type":"boolean"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The programme document."}},"required":["term","in_programme","title","responsible_minister","expected_introduction","status","delayed","source_url"],"additionalProperties":false},"Forecast":{"$id":"#/components/schemas/Forecast","type":"object","properties":{"next_step":{"type":["string","null"]},"expected_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"interval":{"anyOf":[{"type":"object","properties":{"from":{"$ref":"#/components/schemas/Day"},"to":{"$ref":"#/components/schemas/Day"}},"required":["from","to"],"additionalProperties":false,"description":"The 25-75 % range."},{"type":"null"}]},"basis_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"basis":{"type":"string","description":"Localised: what the estimate is built on."},"latest_step":{"type":["string","null"]},"latest_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"passage":{"anyOf":[{"type":"object","properties":{"expected_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"interval":{"anyOf":[{"type":"object","properties":{"from":{"$ref":"#/components/schemas/Day"},"to":{"$ref":"#/components/schemas/Day"}},"required":["from","to"],"additionalProperties":false,"description":"The 25-75 % range."},{"type":"null"}]},"basis_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"basis":{"type":"string"}},"required":["expected_date","interval","basis_count","basis"],"additionalProperties":false},{"type":"null"}]},"message":{"type":"string","description":"Localised: that this is an estimate."}},"required":["next_step","expected_date","interval","basis_count","basis","latest_step","latest_date","passage","message"],"additionalProperties":false,"description":"For an open bill: when its next step and passage are expected, from earlier bills' courses."},"CouncilTreatment":{"$id":"#/components/schemas/CouncilTreatment","type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"meeting_id":{"$ref":"#/components/schemas/EntityId"},"committee":{"anyOf":[{"$ref":"#/components/schemas/OrganizationRef"},{"type":"null"}]},"minutes":{"type":"boolean"},"decision":{"type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","title","date","meeting_id","committee","minutes","decision","source_url"],"additionalProperties":false},"MatterDetailItem":{"$id":"#/components/schemas/MatterDetailItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"matter_type":{"type":"string","enum":["bill","bill.budget","resolution","motion","motion.procedural","appropriation-request","question","question.written","question.oral","question.committee","interpellation","consultation-meeting","general-committee-matter","report","eu-matter","debate","regulation","election-appointment","petition","council-case","council-motion","council-question","audit","procurement","other"]},"matter_type_label":{"type":"string"},"matter_type_native":{"type":["string","null"]},"matter_status":{"anyOf":[{"type":"string","enum":["pending","in-committee","reported","passed","passed-final","enacted","rejected","withdrawn","lapsed","answered","concluded","referred-back","in-mediation","other"]},{"type":"null"}]},"matter_status_label":{"type":["string","null"]},"matter_status_native":{"description":"The source's own status, e.g. `Vedtaget`.","type":["string","null"]},"term":{"anyOf":[{"$ref":"#/components/schemas/TermRef"},{"type":"null"}]},"source_url_note":{"description":"Localised note on `source_url` when the source needs one; null when the link is the page itself or there is no page.","type":["string","null"]},"oversight_assessment":{"anyOf":[{"type":"object","properties":{"criticism":{"anyOf":[{"type":"string","enum":["sharpest-criticism","sharp-criticism","criticism","reprimand"]},{"type":"null"}],"description":"The step of the oversight body's criticism scale its release uses."},"assessment":{"anyOf":[{"type":"string","enum":["entirely-unacceptable","unacceptable","deeply-worrying","very-unsatisfactory","unsatisfactory","worrying","not-entirely-satisfactory","satisfactory"]},{"type":"null"}],"description":"The most severe assessment word its release uses."},"phrases":{"type":"array","items":{"type":"string"},"description":"The words as the release writes them."},"date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The release the verdict was read from."},"confidence":{"anyOf":[{"type":"string","enum":["certain","high","medium","low"]},{"type":"null"}],"description":"How sure the link between the release and the matter is."}},"required":["criticism","assessment","phrases","date","source_url","confidence"],"additionalProperties":false},{"type":"null"}],"description":"An audit matter's verdict from the parliamentary oversight body (Denmark: Statsrevisorerne's press release on the report); null for other matters."},"description":{"description":"The source's abstract, without placeholders.","type":["string","null"]},"introduced_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"concluded_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"subjects":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string"},"value":{"type":"string"},"type":{"type":["string","null"]}},"required":["scheme","value","type"],"additionalProperties":false}},"split_from":{"anyOf":[{"$ref":"#/components/schemas/MatterRef"},{"type":"null"}],"description":"For a part of a split bill: the bill it was split from."},"reintroduced_as":{"anyOf":[{"$ref":"#/components/schemas/MatterRef"},{"type":"null"}]},"reintroduced_from":{"anyOf":[{"$ref":"#/components/schemas/MatterRef"},{"type":"null"}]},"enacted_as":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","title","source_url"],"additionalProperties":false},{"type":"null"}],"description":"The act the bill became, with its official address."}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","matter_type","matter_type_label","matter_type_native","matter_status","matter_status_label","matter_status_native","term","source_url_note","oversight_assessment","description","introduced_date","concluded_date","subjects","split_from","reintroduced_as","reintroduced_from","enacted_as"],"additionalProperties":false},"GetMatterResponse":{"$id":"#/components/schemas/GetMatterResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/MatterDetailItem"},"message":{"type":["string","null"]},"coverage":{"$ref":"#/components/schemas/Coverage"},"quota":{"$ref":"#/components/schemas/Quota"},"timeline":{"type":"array","items":{"$ref":"#/components/schemas/MatterAction"},"description":"The matter's actions, oldest first."},"timeline_message":{"description":"Localised, when only the latest actions are shown.","type":["string","null"]},"votes":{"type":"array","items":{"$ref":"#/components/schemas/MatterVote"}},"debates":{"type":"array","items":{"$ref":"#/components/schemas/Debate"}},"consultations":{"type":"array","items":{"$ref":"#/components/schemas/MatterConsultation"}},"actors":{"type":"array","items":{"$ref":"#/components/schemas/ActorRef"},"description":"Organisations first, then persons; a post's holder when the matter began."},"agenda_items":{"type":"array","items":{"$ref":"#/components/schemas/CouncilTreatment"},"description":"A council case's treatments at meetings, oldest first."},"documents":{"type":"array","items":{"$ref":"#/components/schemas/MatterDocument"},"description":"One page of the matter's documents, ranked by type, oldest first within a type."},"document_type_counts":{"type":"array","items":{"$ref":"#/components/schemas/DocumentTypeCount"}},"documents_total":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Documents matching `document_type`."},"next_cursor":{"description":"The next page of documents; that page has `item` and `documents` only filled.","type":["string","null"]},"programme_item":{"anyOf":[{"$ref":"#/components/schemas/ProgrammeItem"},{"type":"null"}]},"forecast":{"anyOf":[{"$ref":"#/components/schemas/Forecast"},{"type":"null"}]}},"required":["item","message","timeline","timeline_message","votes","debates","consultations","actors","agenda_items","documents","document_type_counts","documents_total","next_cursor","programme_item","forecast"],"additionalProperties":false},"FindMatterResponse":{"$id":"#/components/schemas/FindMatterResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/MatterDetailItem"},"message":{"type":["string","null"]},"coverage":{"$ref":"#/components/schemas/Coverage"},"quota":{"$ref":"#/components/schemas/Quota"},"timeline":{"type":"array","items":{"$ref":"#/components/schemas/MatterAction"},"description":"The matter's actions, oldest first."},"timeline_message":{"description":"Localised, when only the latest actions are shown.","type":["string","null"]},"votes":{"type":"array","items":{"$ref":"#/components/schemas/MatterVote"}},"debates":{"type":"array","items":{"$ref":"#/components/schemas/Debate"}},"consultations":{"type":"array","items":{"$ref":"#/components/schemas/MatterConsultation"}},"actors":{"type":"array","items":{"$ref":"#/components/schemas/ActorRef"},"description":"Organisations first, then persons; a post's holder when the matter began."},"agenda_items":{"type":"array","items":{"$ref":"#/components/schemas/CouncilTreatment"},"description":"A council case's treatments at meetings, oldest first."},"documents":{"type":"array","items":{"$ref":"#/components/schemas/MatterDocument"},"description":"One page of the matter's documents, ranked by type, oldest first within a type."},"document_type_counts":{"type":"array","items":{"$ref":"#/components/schemas/DocumentTypeCount"}},"documents_total":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Documents matching `document_type`."},"next_cursor":{"description":"The next page of documents; that page has `item` and `documents` only filled.","type":["string","null"]},"programme_item":{"anyOf":[{"$ref":"#/components/schemas/ProgrammeItem"},{"type":"null"}]},"forecast":{"anyOf":[{"$ref":"#/components/schemas/Forecast"},{"type":"null"}]},"other_matches":{"type":"array","items":{"$ref":"#/components/schemas/MatterRef"},"description":"Matters with the same reference in other terms, newest first."}},"required":["item","message","timeline","timeline_message","votes","debates","consultations","actors","agenda_items","documents","document_type_counts","documents_total","next_cursor","programme_item","forecast","other_matches"],"additionalProperties":false},"MeetingItem":{"$id":"#/components/schemas/MeetingItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"meeting_type":{"type":"string","enum":["plenary","committee","council","executive","hearing","public-meeting","official-engagement","other"]},"meeting_type_label":{"type":"string"},"meeting_status":{"anyOf":[{"type":"string","enum":["scheduled","held","cancelled","postponed","other"]},{"type":"null"}]},"meeting_status_label":{"type":["string","null"]},"number":{"type":["string","null"]},"start_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"end_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"location":{"type":["string","null"]},"committee":{"anyOf":[{"$ref":"#/components/schemas/OrganizationRef"},{"type":"null"}]},"public":{"type":"boolean"},"agenda_item_count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","meeting_type","meeting_type_label","meeting_status","meeting_status_label","number","start_at","end_at","location","committee","public","agenda_item_count"],"additionalProperties":false},"ListMeetingsResponse":{"$id":"#/components/schemas/ListMeetingsResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/MeetingItem"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"coverage":{"$ref":"#/components/schemas/Coverage"},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","next_cursor","filters","message"],"additionalProperties":false},"AgendaDecision":{"$id":"#/components/schemas/AgendaDecision","type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"text":{"type":"string","description":"The decision as the minutes write it (an excerpt in lists)."},"outcome":{"type":"string","enum":["approved","approved-amended","rejected","postponed","referred","noted","withdrawn","no-decision","other"]},"outcome_label":{"type":"string"},"decided_by":{"anyOf":[{"$ref":"#/components/schemas/OrganizationRef"},{"type":"null"}]}},"required":["id","text","outcome","outcome_label","decided_by"],"additionalProperties":false,"description":"From the minutes only; null on an agenda without minutes."},"Annex":{"$id":"#/components/schemas/Annex","type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"title":{"type":["string","null"]},"file_id":{"type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","title","file_id","source_url"],"additionalProperties":false},"OtherTreatment":{"$id":"#/components/schemas/OtherTreatment","type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"meeting_id":{"$ref":"#/components/schemas/EntityId"},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"committee":{"anyOf":[{"$ref":"#/components/schemas/OrganizationRef"},{"type":"null"}]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","meeting_id","date","committee","source_url"],"additionalProperties":false},"AgendaItem":{"$id":"#/components/schemas/AgendaItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"meeting_id":{"$ref":"#/components/schemas/EntityId"},"number":{"type":["string","null"]},"position":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"committee":{"anyOf":[{"$ref":"#/components/schemas/OrganizationRef"},{"type":"null"}]},"public":{"type":"boolean"},"minutes":{"type":"boolean","description":"The meeting has minutes (else only an agenda)."},"decision":{"anyOf":[{"$ref":"#/components/schemas/AgendaDecision"},{"type":"null"}]},"agenda_document_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}],"description":"The agenda or minutes document the item is in."},"annexes":{"maxItems":5,"type":"array","items":{"$ref":"#/components/schemas/Annex"},"description":"The first five annexes."},"annex_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"other_treatments":{"type":"array","items":{"$ref":"#/components/schemas/OtherTreatment"},"description":"The same case at the authority's other meetings."},"matter":{"anyOf":[{"$ref":"#/components/schemas/MatterRef"},{"type":"null"}],"description":"The council case, by the item's case number."}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","meeting_id","number","position","committee","public","minutes","decision","agenda_document_id","annexes","annex_count","other_treatments","matter"],"additionalProperties":false},"ListAgendaItemsResponse":{"$id":"#/components/schemas/ListAgendaItemsResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/AgendaItem"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"interpretation":{"description":"Localised: how the query was read (dropped words, broadening, semantic hits).","type":["string","null"]},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"coverage":{"$ref":"#/components/schemas/Coverage"},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","next_cursor","filters","interpretation","message"],"additionalProperties":false},"GetAgendaItemResponse":{"$id":"#/components/schemas/GetAgendaItemResponse","type":"object","properties":{"item":{"type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"meeting_id":{"$ref":"#/components/schemas/EntityId"},"number":{"type":["string","null"]},"position":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"committee":{"anyOf":[{"$ref":"#/components/schemas/OrganizationRef"},{"type":"null"}]},"public":{"type":"boolean"},"minutes":{"type":"boolean","description":"The meeting has minutes (else only an agenda)."},"decision":{"anyOf":[{"$ref":"#/components/schemas/AgendaDecision"},{"type":"null"}]},"agenda_document_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}],"description":"The agenda or minutes document the item is in."},"annexes":{"type":"array","items":{"$ref":"#/components/schemas/Annex"},"description":"Every annex."},"annex_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"other_treatments":{"type":"array","items":{"$ref":"#/components/schemas/OtherTreatment"},"description":"The same case at the authority's other meetings."},"matter":{"anyOf":[{"$ref":"#/components/schemas/MatterRef"},{"type":"null"}],"description":"The council case, by the item's case number."},"text":{"description":"The item's text (case presentation, recommendation).","type":["string","null"]},"previous_treatment":{"type":["string","null"]}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","meeting_id","number","position","committee","public","minutes","decision","agenda_document_id","annexes","annex_count","other_treatments","matter","text","previous_treatment"],"additionalProperties":false},"message":{"type":["string","null"]},"coverage":{"$ref":"#/components/schemas/Coverage"},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["item","message"],"additionalProperties":false},"GetMeetingResponse":{"$id":"#/components/schemas/GetMeetingResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/MeetingItem"},"message":{"type":["string","null"]},"coverage":{"$ref":"#/components/schemas/Coverage"},"quota":{"$ref":"#/components/schemas/Quota"},"documents":{"type":"array","items":{"$ref":"#/components/schemas/DocumentRef"},"description":"Agenda, supplementary agenda and minutes."},"agenda_items":{"type":"array","items":{"$ref":"#/components/schemas/AgendaItem"},"description":"Every item in the agenda's order."}},"required":["item","message","documents","agenda_items"],"additionalProperties":false},"Definitions":{"$id":"#/components/schemas/Definitions","type":"object","propertyNames":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"},"additionalProperties":{"type":"string"},"description":"Localised definitions of the figures, keyed by field name (catalogue `api.definitions.*`)."},"PersonRef":{"$id":"#/components/schemas/PersonRef","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The person's page at the source."}},"required":["id","name","source_url"],"additionalProperties":false},"MatterBrief":{"$id":"#/components/schemas/MatterBrief","type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"reference":{"type":["string","null"]},"title":{"type":["string","null"]}},"required":["id","reference","title"],"additionalProperties":false},"Speaker":{"$id":"#/components/schemas/Speaker","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"name":{"type":"string"},"title":{"description":"The office spoken in, e.g. a minister's title.","type":["string","null"]},"as_written":{"type":"string","description":"The speaker as the transcript writes it."},"party":{"description":"Party short name on the day.","type":["string","null"]},"party_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"role":{"type":"string","enum":["chair","member","minister","rapporteur","short-remark","rejoinder","asker","guest","other"]},"role_label":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","name","title","as_written","party","party_id","role","role_label","source_url"],"additionalProperties":false},"SpeechItem":{"$id":"#/components/schemas/SpeechItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"speaker":{"$ref":"#/components/schemas/Speaker"},"matter":{"anyOf":[{"$ref":"#/components/schemas/MatterBrief"},{"type":"null"}]},"reading":{"description":"The reading or debate as the source names it.","type":["string","null"]},"matter_action_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"meeting":{"anyOf":[{"type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"number":{"type":["string","null"]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]}},"required":["id","number","title","date"],"additionalProperties":false},{"type":"null"}]},"venue":{"type":"string","enum":["chamber","committee","council"]},"transcript_kind":{"type":"string","enum":["official","machine"],"description":"`official`: the parliament's own transcript; `machine`: our transcript of the meeting's video (captions or speech recognition), never an official record."},"document_status":{"anyOf":[{"type":"string","enum":["draft","provisional","final","distributed","withdrawn","machine","other"]},{"type":"null"}]},"document_status_label":{"type":["string","null"]},"edition":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"Edition of the transcript."},"transcript_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official transcript's page; null for a machine transcript."},"video_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The meeting's video at the speech: the chamber's player from its start to its end, a committee or council video at its start where the platform takes a time, else the video's page."},"video_start":{"anyOf":[{"type":"string","pattern":"^\\d{2}:\\d{2}:\\d{2}$"},{"type":"null"}],"description":"The chamber: wall-clock start; a committee or council video: offset into the video."},"video_end":{"anyOf":[{"type":"string","pattern":"^\\d{2}:\\d{2}:\\d{2}$"},{"type":"null"}]},"transcript_file_id":{"anyOf":[{"$ref":"#/components/schemas/FileId"},{"type":"null"}],"description":"For GET /v2/documents/{id}/pages; null until read."},"char_from":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"char_to":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"word_count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","speaker","matter","reading","matter_action_id","meeting","venue","transcript_kind","document_status","document_status_label","edition","transcript_url","video_url","video_start","video_end","transcript_file_id","char_from","char_to","word_count"],"additionalProperties":false},"SpeechesResponse":{"$id":"#/components/schemas/SpeechesResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/SpeechItem"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"total":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Matches in all; null when not counted."},"total_exact":{"type":"boolean","description":"False when `total` is a lower bound."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"interpretation":{"description":"Localised: how the query was read (dropped words, broadening, semantic hits).","type":["string","null"]},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"},"counts_per_party":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"party":{"type":"string"},"count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["party","count"],"additionalProperties":false}},{"type":"null"}],"description":"With `q`: speeches per party over every match; null without `q` or past the time budget."},"counts_per_year":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["year","count"],"additionalProperties":false}},{"type":"null"}]}},"required":["items","count","total","total_exact","next_cursor","filters","interpretation","message","counts_per_party","counts_per_year"],"additionalProperties":false},"CohesionRow":{"$id":"#/components/schemas/CohesionRow","type":"object","properties":{"party":{"type":"string"},"party_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"party_name":{"type":"string"},"votes":{"type":"integer","minimum":0,"maximum":9007199254740991},"cohesion":{"type":"number","minimum":0,"maximum":1},"unanimous_votes":{"type":"integer","minimum":0,"maximum":9007199254740991},"votes_cast":{"type":"integer","minimum":0,"maximum":9007199254740991},"absence_share":{"type":"number","minimum":0,"maximum":1}},"required":["party","party_id","party_name","votes","cohesion","unanimous_votes","votes_cast","absence_share"],"additionalProperties":false},"AgreementRow":{"$id":"#/components/schemas/AgreementRow","type":"object","properties":{"party_a":{"type":"string"},"party_b":{"type":"string"},"shared_votes":{"type":"integer","minimum":0,"maximum":9007199254740991},"agreed":{"type":"integer","minimum":0,"maximum":9007199254740991},"agreement":{"type":"number","minimum":0,"maximum":1}},"required":["party_a","party_b","shared_votes","agreed","agreement"],"additionalProperties":false},"DissenterRow":{"$id":"#/components/schemas/DissenterRow","type":"object","properties":{"person":{"$ref":"#/components/schemas/PersonRef"},"parties":{"type":"array","items":{"type":"string"}},"dissents":{"type":"integer","minimum":0,"maximum":9007199254740991},"votes_cast":{"type":"integer","minimum":0,"maximum":9007199254740991},"dissent_share":{"type":"number","minimum":0,"maximum":1}},"required":["person","parties","dissents","votes_cast","dissent_share"],"additionalProperties":false},"VoteRow":{"$id":"#/components/schemas/VoteRow","type":"object","properties":{"id":{"description":"The vote event.","$ref":"#/components/schemas/EntityId"},"date":{"$ref":"#/components/schemas/DayOrDateTime"},"number":{"type":["string","null"]},"vote_classification":{"type":"string","enum":["final-passage","committee-recommendation","motion","amendment","other"]},"vote_classification_label":{"type":"string"},"vote_classification_native":{"type":["string","null"]},"passed":{"type":["boolean","null"]},"matter":{"anyOf":[{"$ref":"#/components/schemas/MatterBrief"},{"type":"null"}]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]},"parties":{"type":"array","items":{"type":"object","properties":{"party":{"type":"string"},"line":{"type":"string","enum":["yes","no","abstain","split","absent"]},"yes":{"type":"integer","minimum":0,"maximum":9007199254740991},"no":{"type":"integer","minimum":0,"maximum":9007199254740991},"abstain":{"type":"integer","minimum":0,"maximum":9007199254740991},"absent":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["party","line","yes","no","abstain","absent"],"additionalProperties":false}},"person_vote":{"anyOf":[{"type":"string","enum":["yes","no","abstain","absent","paired","excused","other"]},{"type":"null"}],"description":"With `person`: their vote."},"person_party":{"type":["string","null"]},"dissent":{"description":"With `person`: voted against the party line.","type":["boolean","null"]}},"required":["id","date","number","vote_classification","vote_classification_label","vote_classification_native","passed","matter","source_url","parties","person_vote","person_party","dissent"],"additionalProperties":false},"VotesResponse":{"$id":"#/components/schemas/VotesResponse","type":"object","properties":{"items":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/CohesionRow"},{"$ref":"#/components/schemas/AgreementRow"},{"$ref":"#/components/schemas/DissenterRow"},{"$ref":"#/components/schemas/VoteRow"}]}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"},"view":{"type":"string","enum":["cohesion","agreement","dissenters","votes"]},"computed_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"definitions":{"$ref":"#/components/schemas/Definitions"}},"required":["items","count","next_cursor","filters","message","view","computed_at","definitions"],"additionalProperties":false},"ResponseTimeAggregates":{"$id":"#/components/schemas/ResponseTimeAggregates","type":"object","properties":{"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"answered":{"type":"integer","minimum":0,"maximum":9007199254740991},"open":{"type":"integer","minimum":0,"maximum":9007199254740991},"lapsed":{"type":"integer","minimum":0,"maximum":9007199254740991},"median_days":{"type":["number","null"]},"p90_days":{"type":["number","null"]},"overdue_share":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"overdue_without_postponement_share":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"postponed_share":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"open_past_deadline":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["count","answered","open","lapsed","median_days","p90_days","overdue_share","overdue_without_postponement_share","postponed_share","open_past_deadline"],"additionalProperties":false},"ResponseTimeGroup":{"$id":"#/components/schemas/ResponseTimeGroup","type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"answered":{"type":"integer","minimum":0,"maximum":9007199254740991},"open":{"type":"integer","minimum":0,"maximum":9007199254740991},"lapsed":{"type":"integer","minimum":0,"maximum":9007199254740991},"median_days":{"type":["number","null"]},"p90_days":{"type":["number","null"]},"overdue_share":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"overdue_without_postponement_share":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"postponed_share":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"open_past_deadline":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["key","label","count","answered","open","lapsed","median_days","p90_days","overdue_share","overdue_without_postponement_share","postponed_share","open_past_deadline"],"additionalProperties":false},"QuestionItem":{"$id":"#/components/schemas/QuestionItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"question_type":{"type":"string","enum":["bill","bill.budget","resolution","motion","motion.procedural","appropriation-request","question","question.written","question.oral","question.committee","interpellation","consultation-meeting","general-committee-matter","report","eu-matter","debate","regulation","election-appointment","petition","council-case","council-motion","council-question","audit","procurement","other"]},"question_type_label":{"type":"string"},"number":{"type":["string","null"]},"asked_on":{"$ref":"#/components/schemas/Day"},"deadline":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"deadline_basis":{"type":"string","description":"Localised: which rule set the deadline."},"answered_on":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"days":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"days_overdue":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"status":{"type":"string","enum":["open","answered","lapsed"]},"overdue":{"type":"boolean"},"postponed":{"type":"boolean"},"provisional_answer_on":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"answer":{"anyOf":[{"type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","source_url"],"additionalProperties":false},{"type":"null"}]},"post":{"description":"The minister's post the question went to.","type":["string","null"]},"minister":{"anyOf":[{"$ref":"#/components/schemas/PersonRef"},{"type":"null"}]},"asker":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"name":{"type":"string"},"party":{"type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","name","party","source_url"],"additionalProperties":false},{"type":"null"}]},"committee":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","name","source_url"],"additionalProperties":false},{"type":"null"}]},"matter_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","question_type","question_type_label","number","asked_on","deadline","deadline_basis","answered_on","days","days_overdue","status","overdue","postponed","provisional_answer_on","answer","post","minister","asker","committee","matter_id"],"additionalProperties":false},"QuestionResponseTimesResponse":{"$id":"#/components/schemas/QuestionResponseTimesResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/QuestionItem"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"},"aggregates":{"$ref":"#/components/schemas/ResponseTimeAggregates"},"groups":{"anyOf":[{"maxItems":50,"type":"array","items":{"$ref":"#/components/schemas/ResponseTimeGroup"}},{"type":"null"}]},"computed_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"definitions":{"$ref":"#/components/schemas/Definitions"}},"required":["items","count","next_cursor","filters","message","aggregates","groups","computed_at","definitions"],"additionalProperties":false},"WhoamiResponse":{"$id":"#/components/schemas/WhoamiResponse","type":"object","properties":{"organization_id":{"type":"string","description":"The organisation the key or token belongs to."},"key_id":{"description":"The API key's id; absent for OAuth tokens.","type":"string"},"channel":{"type":"string","enum":["key","oauth"]}},"required":["organization_id","channel"],"additionalProperties":false},"OpenApiDocument":{"$id":"#/components/schemas/OpenApiDocument","type":"object","properties":{"openapi":{"type":"string","const":"3.1.0"},"info":{"type":"object","properties":{"title":{"type":"string"},"version":{"type":"string"}},"required":["title","version"],"additionalProperties":{}},"paths":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"components":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["openapi","info","paths","components"],"additionalProperties":{},"description":"This document."},"ResolveResponse":{"$id":"#/components/schemas/ResolveResponse","type":"object","properties":{"id":{"type":"string"},"entity_type":{"type":"string","enum":["jurisdiction","body","organization","person","post","term","matter","matter_action","document","file","meeting","agenda_item","decision","vote_event","speech","consultation","consultation_response","legal_act","publication","procurement_notice","ruling","change"]},"url":{"anyOf":[{"type":"string","pattern":"^\\/v2\\/"},{"type":"null"}],"description":"The detail route that answers the id, relative to the API's base (`/v2/matters/dk:folketing:sag:106086`); null when no route shows the entity on its own (a person, a vote)."},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["id","entity_type","url"],"additionalProperties":false},"ProcurementBuyer":{"$id":"#/components/schemas/ProcurementBuyer","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}],"description":"The buyer's organization; null when it has no id."},"name":{"type":["string","null"]},"identifier":{"description":"`scheme:value`, e.g. `dk:cvr:29189420`, or the id as the notice gives it.","type":["string","null"]}},"required":["id","name","identifier"],"additionalProperties":false},"ProcurementWinner":{"$id":"#/components/schemas/ProcurementWinner","type":"object","properties":{"name":{"type":["string","null"]},"identifier":{"description":"As the notice gives it (a CVR number, a VAT id).","type":["string","null"]},"country":{"description":"ISO 3166-1 alpha-3 when the notice pairs it.","type":["string","null"]}},"required":["name","identifier","country"],"additionalProperties":false,"description":"A winning tenderer. Names, ids and countries are paired only where the portal pairs them."},"ProcurementItem":{"$id":"#/components/schemas/ProcurementItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"notice_type":{"type":"string","enum":["planning","competition","direct-award","result","modification","change","completion","other"]},"notice_type_label":{"type":"string"},"procedure_type":{"anyOf":[{"type":"string","enum":["open","restricted","negotiated","negotiated-without-publication","competitive-dialogue","innovation-partnership","other-single-stage","other-multi-stage","other"]},{"type":"null"}]},"procedure_type_label":{"type":["string","null"]},"procedure_type_native":{"type":["string","null"]},"procedure_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}],"description":"The procedure (a matter) the notice belongs to."},"document_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}],"description":"The notice as a document (its text and files)."},"buyers":{"type":"array","items":{"$ref":"#/components/schemas/ProcurementBuyer"}},"cpv_main":{"type":["string","null"]},"cpv_codes":{"type":"array","items":{"type":"string"}},"contract_nature":{"description":"`works`, `supplies`, `services` (eForms).","type":["string","null"]},"estimated_value":{"type":["number","null"]},"estimated_currency":{"type":["string","null"]},"awarded_value":{"type":["number","null"]},"awarded_currency":{"type":["string","null"]},"tender_deadline":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the notice gives a time of day."},"tender_deadline_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"place_nuts":{"type":"array","items":{"type":"string"},"description":"NUTS codes (or a country code) of the place."},"winners":{"type":"array","items":{"$ref":"#/components/schemas/ProcurementWinner"}},"award_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"contract_conclusion_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"lot_count":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","notice_type","notice_type_label","procedure_type","procedure_type_label","procedure_type_native","procedure_id","document_id","buyers","cpv_main","cpv_codes","contract_nature","estimated_value","estimated_currency","awarded_value","awarded_currency","tender_deadline","tender_deadline_date","place_nuts","winners","award_date","contract_conclusion_date","lot_count"],"additionalProperties":false},"ListProcurementResponse":{"$id":"#/components/schemas/ListProcurementResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ProcurementItem"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"coverage":{"$ref":"#/components/schemas/Coverage"},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","next_cursor","filters","message"],"additionalProperties":false},"ProcurementNoticeRef":{"$id":"#/components/schemas/ProcurementNoticeRef","type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"notice_type":{"type":"string","enum":["planning","competition","direct-award","result","modification","change","completion","other"]},"notice_type_label":{"type":"string"},"date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"title":{"type":["string","null"]},"reference":{"type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","notice_type","notice_type_label","date","title","reference","source_url"],"additionalProperties":false},"ProcurementDetailItem":{"$id":"#/components/schemas/ProcurementDetailItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"notice_type":{"type":"string","enum":["planning","competition","direct-award","result","modification","change","completion","other"]},"notice_type_label":{"type":"string"},"procedure_type":{"anyOf":[{"type":"string","enum":["open","restricted","negotiated","negotiated-without-publication","competitive-dialogue","innovation-partnership","other-single-stage","other-multi-stage","other"]},{"type":"null"}]},"procedure_type_label":{"type":["string","null"]},"procedure_type_native":{"type":["string","null"]},"procedure_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}],"description":"The procedure (a matter) the notice belongs to."},"document_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}],"description":"The notice as a document (its text and files)."},"buyers":{"type":"array","items":{"$ref":"#/components/schemas/ProcurementBuyer"}},"cpv_main":{"type":["string","null"]},"cpv_codes":{"type":"array","items":{"type":"string"}},"contract_nature":{"description":"`works`, `supplies`, `services` (eForms).","type":["string","null"]},"estimated_value":{"type":["number","null"]},"estimated_currency":{"type":["string","null"]},"awarded_value":{"type":["number","null"]},"awarded_currency":{"type":["string","null"]},"tender_deadline":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the notice gives a time of day."},"tender_deadline_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"place_nuts":{"type":"array","items":{"type":"string"},"description":"NUTS codes (or a country code) of the place."},"winners":{"type":"array","items":{"$ref":"#/components/schemas/ProcurementWinner"}},"award_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"contract_conclusion_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"lot_count":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"description":{"type":["string","null"]},"dispatch_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"request_deadline":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"Deadline for requests to participate."},"attributes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"What only the source gives (`attributes.<country>.<source>`)."}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","notice_type","notice_type_label","procedure_type","procedure_type_label","procedure_type_native","procedure_id","document_id","buyers","cpv_main","cpv_codes","contract_nature","estimated_value","estimated_currency","awarded_value","awarded_currency","tender_deadline","tender_deadline_date","place_nuts","winners","award_date","contract_conclusion_date","lot_count","description","dispatch_date","request_deadline","attributes"],"additionalProperties":false},"GetProcurementNoticeResponse":{"$id":"#/components/schemas/GetProcurementNoticeResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/ProcurementDetailItem"},"message":{"type":["string","null"]},"coverage":{"$ref":"#/components/schemas/Coverage"},"quota":{"$ref":"#/components/schemas/Quota"},"procedure_notices":{"type":"array","items":{"$ref":"#/components/schemas/ProcurementNoticeRef"},"description":"The other notices of the same procedure, oldest first."}},"required":["item","message","procedure_notices"],"additionalProperties":false},"Reuse":{"$id":"#/components/schemas/Reuse","type":"object","properties":{"passage_excerpt":{"type":"string"},"similarity":{"type":"number","minimum":0,"maximum":1,"description":"Share of identical 5-word sequences."},"shared_words":{"type":"integer","minimum":0,"maximum":9007199254740991},"direction":{"anyOf":[{"type":"string","enum":["earlier","later","unknown"]},{"type":"null"}],"description":"Null for a pasted text."},"earliest_id":{"type":["string","null"]},"copy":{"type":"boolean","description":"A version of the same document."},"this":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"char_from":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"char_to":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","page","char_from","char_to","source_url"],"additionalProperties":false},{"type":"null"}],"description":"The passage in the asked document; null for `text`."},"other":{"type":"object","properties":{"id":{"type":"string"},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"char_from":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"char_to":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","page","char_from","char_to","source_url"],"additionalProperties":false},"consultation_response":{"anyOf":[{"type":"object","properties":{"document_id":{"$ref":"#/components/schemas/EntityId"},"sender":{"type":["string","null"]},"stakeholder":{"anyOf":[{"type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"private_person":{"type":"boolean"}},"required":["document_id","sender","stakeholder","private_person"],"additionalProperties":false},{"type":"null"}],"description":"When one document is a consultation response (a private person only as such)."}},"required":["passage_excerpt","similarity","shared_words","direction","earliest_id","copy","this","other","consultation_response"],"additionalProperties":false},"ReuseItem":{"$id":"#/components/schemas/ReuseItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"reuse":{"$ref":"#/components/schemas/Reuse"}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","reuse"],"additionalProperties":false},"TextReuseResponse":{"$id":"#/components/schemas/TextReuseResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ReuseItem"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","next_cursor","filters","message"],"additionalProperties":false},"RulingParty":{"$id":"#/components/schemas/RulingParty","type":"object","properties":{"name":{"type":"string"},"role":{"description":"As the board puts it: `indklagede`, `myndighed`, ...","type":["string","null"]},"identifier":{"description":"`scheme:value`, e.g. `dk:cvr:29189854`.","type":["string","null"]}},"required":["name","role","identifier"],"additionalProperties":false,"description":"A company or authority the ruling concerns. Private persons are never listed."},"RulingItem":{"$id":"#/components/schemas/RulingItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"ruling_type":{"type":"string","enum":["decision","ruling","opinion","binding-answer","principle-decision","judgment","summary","other"]},"ruling_type_label":{"type":"string"},"ruling_type_native":{"type":["string","null"]},"issuer_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}],"description":"The board's organization."},"issuer_name":{"type":["string","null"]},"issuer_kind":{"anyOf":[{"type":"string","enum":["state","private","ombudsman"]},{"type":"null"}]},"references":{"type":"array","items":{"type":"string"},"description":"Every journal number; `reference` is the first."},"ruling_summary":{"description":"The board's own summary, when it gives one.","type":["string","null"]},"decided_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"published_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"subject_areas":{"type":"array","items":{"type":"string"}},"legal_basis":{"type":"array","items":{"type":"string"}},"outcome":{"anyOf":[{"type":"string","enum":["allowed","partly-allowed","rejected","remitted","annulled","dismissed","other"]},{"type":"null"}],"description":"Rigsdata's classification of the board's own words, from the complainant's side; null when the words state no outcome we recognise."},"outcome_label":{"type":["string","null"]},"outcome_native":{"description":"The board's own outcome words, when given.","type":["string","null"]},"parties":{"type":"array","items":{"$ref":"#/components/schemas/RulingParty"}},"principle":{"type":["boolean","null"]},"court_referral":{"description":"The case was brought before the courts.","type":["boolean","null"]},"expires_on":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}],"description":"Rigsdata deletes the ruling on this day (it names a person and the board's period ends)."},"document_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}],"description":"The ruling as a document (its text and files)."}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","ruling_type","ruling_type_label","ruling_type_native","issuer_id","issuer_name","issuer_kind","references","ruling_summary","decided_date","published_date","subject_areas","legal_basis","outcome","outcome_label","outcome_native","parties","principle","court_referral","expires_on","document_id"],"additionalProperties":false},"ListRulingsResponse":{"$id":"#/components/schemas/ListRulingsResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/RulingItem"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"coverage":{"$ref":"#/components/schemas/Coverage"},"quota":{"$ref":"#/components/schemas/Quota"},"outcomes":{"type":"array","items":{"$ref":"#/components/schemas/FacetValue"},"description":"Rulings per outcome for every filter but `outcome`, `unclassified` for those Rigsdata could not classify: how often the complainant wins is one call."}},"required":["items","count","next_cursor","filters","message","outcomes"],"additionalProperties":false},"RulingDetailItem":{"$id":"#/components/schemas/RulingDetailItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"ruling_type":{"type":"string","enum":["decision","ruling","opinion","binding-answer","principle-decision","judgment","summary","other"]},"ruling_type_label":{"type":"string"},"ruling_type_native":{"type":["string","null"]},"issuer_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}],"description":"The board's organization."},"issuer_name":{"type":["string","null"]},"issuer_kind":{"anyOf":[{"type":"string","enum":["state","private","ombudsman"]},{"type":"null"}]},"references":{"type":"array","items":{"type":"string"},"description":"Every journal number; `reference` is the first."},"ruling_summary":{"description":"The board's own summary, when it gives one.","type":["string","null"]},"decided_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"published_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"subject_areas":{"type":"array","items":{"type":"string"}},"legal_basis":{"type":"array","items":{"type":"string"}},"outcome":{"anyOf":[{"type":"string","enum":["allowed","partly-allowed","rejected","remitted","annulled","dismissed","other"]},{"type":"null"}],"description":"Rigsdata's classification of the board's own words, from the complainant's side; null when the words state no outcome we recognise."},"outcome_label":{"type":["string","null"]},"outcome_native":{"description":"The board's own outcome words, when given.","type":["string","null"]},"parties":{"type":"array","items":{"$ref":"#/components/schemas/RulingParty"}},"principle":{"type":["boolean","null"]},"court_referral":{"description":"The case was brought before the courts.","type":["boolean","null"]},"expires_on":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}],"description":"Rigsdata deletes the ruling on this day (it names a person and the board's period ends)."},"document_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}],"description":"The ruling as a document (its text and files)."},"attributes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"What only the source gives (`attributes.<country>.<source>`)."}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","ruling_type","ruling_type_label","ruling_type_native","issuer_id","issuer_name","issuer_kind","references","ruling_summary","decided_date","published_date","subject_areas","legal_basis","outcome","outcome_label","outcome_native","parties","principle","court_referral","expires_on","document_id","attributes"],"additionalProperties":false},"GetRulingResponse":{"$id":"#/components/schemas/GetRulingResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/RulingDetailItem"},"message":{"type":["string","null"]},"coverage":{"$ref":"#/components/schemas/Coverage"},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["item","message"],"additionalProperties":false},"RulingIssuer":{"$id":"#/components/schemas/RulingIssuer","type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"slug":{"type":"string"},"name":{"type":"string"},"short_name":{"type":["string","null"]},"kind":{"anyOf":[{"type":"string","enum":["state","private","ombudsman"]},{"type":"null"}]},"parent_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}],"description":"The ministry's organization, for state boards."},"website":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]},"platform":{"description":"How Rigsdata reads it (`retsinformation`, ...).","type":["string","null"]},"read":{"type":"boolean","description":"Whether Rigsdata reads the board's decisions."},"note":{"description":"Why not read, or what is left out.","type":["string","null"]},"rulings":{"type":"integer","minimum":0,"maximum":9007199254740991},"first_decided":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"last_decided":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"last_published":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]}},"required":["id","slug","name","short_name","kind","parent_id","website","platform","read","note","rulings","first_decided","last_decided","last_published"],"additionalProperties":false},"ListRulingIssuersResponse":{"$id":"#/components/schemas/ListRulingIssuersResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/RulingIssuer"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"coverage":{"$ref":"#/components/schemas/Coverage"},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","next_cursor","filters","message"],"additionalProperties":false},"Chain":{"$id":"#/components/schemas/Chain","type":"object","properties":{"matter":{"anyOf":[{"type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"reference":{"type":["string","null"]},"title":{"type":["string","null"]},"matter_type":{"anyOf":[{"type":"string","enum":["bill","bill.budget","resolution","motion","motion.procedural","appropriation-request","question","question.written","question.oral","question.committee","interpellation","consultation-meeting","general-committee-matter","report","eu-matter","debate","regulation","election-appointment","petition","council-case","council-motion","council-question","audit","procurement","other"]},{"type":"null"}]},"matter_type_label":{"type":["string","null"]}},"required":["id","reference","title","matter_type","matter_type_label"],"additionalProperties":false},{"type":"null"}],"description":"The matter the hit belongs to: the bill or case (a committee question's own bill), a consultation's bill, an agenda item's council case. Null when core knows none."},"stage":{"anyOf":[{"type":"string","enum":["consultation","introduced","in_committee","passed","rejected","withdrawn","lapsed","concluded","in_force"]},{"type":"null"}]},"stage_label":{"type":["string","null"]},"stage_date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}],"description":"When the case reached `stage`, when known."},"next":{"anyOf":[{"type":"object","properties":{"event_type":{"type":"string","enum":["consultation_deadline","appeal_deadline","answer_deadline","committee_deadline","reading","consultation_meeting","plenary_meeting","committee_meeting","council_meeting"]},"event_type_label":{"type":"string"},"date":{"$ref":"#/components/schemas/DayOrDateTime"}},"required":["event_type","event_type_label","date"],"additionalProperties":false},{"type":"null"}],"description":"The next dated step core knows: a consultation deadline, a reading, a committee deadline, a council meeting. Null when none is ahead."},"consultation":{"anyOf":[{"type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"title":{"type":["string","null"]},"deadline":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["open","closed","archived"]},{"type":"null"}]},"response_count":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Responses the source lists among the consultation's documents; null when it lists none (which is not 'no responses')."}},"required":["id","title","deadline","status","response_count"],"additionalProperties":false},{"type":"null"}]},"questions":{"anyOf":[{"type":"object","properties":{"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"answered":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["count","answered"],"additionalProperties":false},{"type":"null"}],"description":"The committee questions (and consultation meetings) asked under the matter."},"vote":{"anyOf":[{"type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"classification":{"anyOf":[{"type":"string","enum":["final-passage","committee-recommendation","motion","amendment","other"]},{"type":"null"}]},"classification_label":{"type":["string","null"]},"passed":{"type":["boolean","null"]},"yes":{"type":"integer","minimum":0,"maximum":9007199254740991},"no":{"type":"integer","minimum":0,"maximum":9007199254740991},"abstain":{"type":"integer","minimum":0,"maximum":9007199254740991},"absent":{"type":"integer","minimum":0,"maximum":9007199254740991},"parties":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"party_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"party":{"type":["string","null"]},"line":{"type":"string","enum":["yes","no","abstain","split","absent"]},"yes":{"type":"integer","minimum":0,"maximum":9007199254740991},"no":{"type":"integer","minimum":0,"maximum":9007199254740991},"abstain":{"type":"integer","minimum":0,"maximum":9007199254740991},"absent":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["party_id","party","line","yes","no","abstain","absent"],"additionalProperties":false},"description":"Per party, largest first, at most ten; `line` the option most of its votes cast went to (`split` on a tie, `absent` when none voted)."},"parties_total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","date","classification","classification_label","passed","yes","no","abstain","absent","parties","parties_total"],"additionalProperties":false},{"type":"null"}],"description":"The final vote (else the latest) on the matter, with the counts per party."},"law":{"anyOf":[{"type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"title":{"type":["string","null"]},"act_status":{"anyOf":[{"type":"string","enum":["in-force","repealed","not-yet-in-force","proposed","other"]},{"type":"null"}]},"act_status_label":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"in_force_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]}},"required":["id","title","act_status","act_status_label","date","in_force_date"],"additionalProperties":false},{"type":"null"}],"description":"The legal act the matter became (`enacted-as`), the act a consultation was on, or the act an agenda item mentions."},"local_decisions_count":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Local agenda items that mention the law (`mentions`), or a council case's treatments; null when there is neither a law nor a council case."},"links":{"maxItems":4,"type":"array","items":{"type":"object","properties":{"operation":{"type":"string","enum":["getMatter","legislationLifecycle","getConsultation","getAgendaItem"]},"url":{"type":"string","maxLength":2048,"description":"The route with the id, relative to the API base."}},"required":["operation","url"],"additionalProperties":false},"description":"The detail routes that hold the rest of the chain."}},"required":["matter","stage","stage_label","stage_date","next","consultation","questions","vote","law","local_decisions_count","links"],"additionalProperties":false,"description":"Where the hit's case stands and what it links to (bill, consultation, committee questions, vote, law, local decisions), so a client needs no further call to say where it stands. Only parts core holds are filled."},"SearchPage":{"$id":"#/components/schemas/SearchPage","type":"object","properties":{"page":{"type":"integer","minimum":0,"maximum":9007199254740991},"excerpt":{"type":"string"}},"required":["page","excerpt"],"additionalProperties":false},"SearchItem":{"$id":"#/components/schemas/SearchItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"file_id":{"anyOf":[{"$ref":"#/components/schemas/FileId"},{"type":"null"}],"description":"The file whose page matched; null for a record without a file."},"score":{"description":"Relevance score; null with sort=newest.","type":["number","null"]},"matched_pages":{"type":"integer","minimum":0,"maximum":9007199254740991},"pages":{"maxItems":3,"type":"array","items":{"$ref":"#/components/schemas/SearchPage"},"description":"The up to three best pages."},"matched_by":{"type":"string","enum":["keyword","semantic","both"],"description":"Found on the query's words, on meaning (vector), or both."},"duplicates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]},"relation":{"default":"copy","description":"`copy`: the same document elsewhere (a file id); `record`: the record (matter, consultation, ...) this document is the main text of; `main_text`: a main text of this record, or another main text of the same record (a file id).","type":"string","enum":["copy","record","main_text"]}},"required":["id","source","source_url","relation"],"additionalProperties":false},"description":"Other copies of the same document (same text hash) from other sources, and, with record search, the record and its own documents folded into this one result."},"more_from_parent":{"description":"Present when the instance caps results per parent (a matter, a consultation, an agenda item): the parent's further matching documents (and, with record search, records; their `file_id` null), folded into its first item instead of filling the list. Absent when nothing was folded.","type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":9007199254740991,"description":"Documents folded into this one."},"items":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"file_id":{"anyOf":[{"$ref":"#/components/schemas/FileId"},{"type":"null"}]},"title":{"type":["string","null"]}},"required":["id","file_id","title"],"additionalProperties":false},"description":"The first ten of them, best first."}},"required":["count","items"],"additionalProperties":false},"chain":{"description":"With `SEARCH_CHAIN_SUMMARY`, on a hit whose parent is a matter, a consultation or an agenda item: where that case stands and what it links to. Absent otherwise, and when the summary ran out of its time.","$ref":"#/components/schemas/Chain"},"term":{"anyOf":[{"$ref":"#/components/schemas/TermRef"},{"type":"null"}]},"document_status":{"anyOf":[{"type":"string","enum":["draft","provisional","final","distributed","withdrawn","machine","other"]},{"type":"null"}]},"document_status_label":{"type":["string","null"]},"published_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"attributes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"The source's public attributes, namespaced (`dk.ft.*`); an allowlist per source."},"references":{"maxItems":10,"type":"array","items":{"$ref":"#/components/schemas/PageReference"},"description":"For a document hit: the questions, samrådsspørgsmål and bilag its text refers to, answers first; empty for a record (a matter, a consultation, ...) and when nothing was read."}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","file_id","score","matched_pages","pages","matched_by","duplicates","term","document_status","document_status_label","published_at","attributes","references"],"additionalProperties":false},"InterpretationEntry":{"$id":"#/components/schemas/InterpretationEntry","type":"object","properties":{"kind":{"type":"string","enum":["reference","entity","date","synonym"],"description":"What the words were read as."},"text":{"type":"string","description":"The words as typed."},"value":{"type":"string","description":"What they were read as: a matter id (reference), an entity id (entity), days as an ISO 8601 interval `2026-10-01/2026-10-31` with `..` for an open end, or `P90D` for a recency boost (date), the other forms joined by ` | ` (synonym)."},"label":{"description":"A readable name of `value` (the matter, the entity).","type":["string","null"]},"entity_kind":{"anyOf":[{"type":"string","enum":["municipality","region","party","ministry","minister"]},{"type":"null"}],"description":"For an entity: what it is."},"applied":{"type":"string","enum":["pinned","filter","boost","suggested","expanded"],"description":"`pinned`: shown first; `filter`: narrowed to it; `boost`: its documents ranked higher; `suggested`: not applied, `filter` says how to; `expanded`: also searched as `value`."},"filter":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]}},{"type":"null"}],"description":"The request parameters that apply the reading as a filter (`jurisdiction`, `publisher`, `from_date`, `to_date`); null when there is none."}},"required":["kind","text","value","label","entity_kind","applied","filter"],"additionalProperties":false},"SearchResponse":{"$id":"#/components/schemas/SearchResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/SearchItem"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"total":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Matches in all; null when not counted."},"total_exact":{"type":"boolean","description":"False when `total` is a lower bound."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"interpretation":{"description":"Localised: how the query was read (dropped words, broadening, semantic hits).","type":["string","null"]},"facets":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/FacetValue"}}},{"type":"null"}]},"facets_exact":{"type":["boolean","null"]},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"coverage":{"$ref":"#/components/schemas/Coverage"},"quota":{"$ref":"#/components/schemas/Quota"},"group":{"type":"string","enum":["document","page"]},"sort":{"type":"string","enum":["relevance","newest"]},"mode":{"type":"string","enum":["hybrid","keyword"]},"search_id":{"type":"string","pattern":"^s_[A-Za-z0-9_-]{22}$","description":"Opaque id of this answer: send it as `from_search` (with the result's `rank`) when opening a result."},"interpretation_entries":{"description":"How `q` was read, one entry per reading (references, entities, dates, synonyms); present when the instance reads queries (`SEARCH_QUERY_UNDERSTANDING`). `interpretation` says the same in a sentence.","type":"array","items":{"$ref":"#/components/schemas/InterpretationEntry"}}},"required":["items","count","total","total_exact","next_cursor","filters","interpretation","facets","facets_exact","message","group","sort","mode","search_id"],"additionalProperties":false},"StakeholderItem":{"$id":"#/components/schemas/StakeholderItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"name":{"type":"string"},"slug":{"type":"string"},"respondent_category":{"type":"string","enum":["company","business-association","ngo","interest-group","trade-union","public-authority","academic","citizen","other"]},"respondent_category_label":{"type":"string"},"registered":{"type":"boolean","description":"A known organisation of the instance's register."},"response_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"consultation_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"no_comments_share":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}],"description":"Share of read responses that had no comments."},"invited":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Consultations whose recipient list named the organisation."},"answered_invited":{"type":"integer","minimum":0,"maximum":9007199254740991},"invited_response_rate":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"first_response_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"latest_response_date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"consultations_with_change":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","name","slug","respondent_category","respondent_category_label","registered","response_count","consultation_count","no_comments_share","invited","answered_invited","invited_response_rate","first_response_date","latest_response_date","consultations_with_change","changes"],"additionalProperties":false},"StakeholdersResponse":{"$id":"#/components/schemas/StakeholdersResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/StakeholderItem"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"coverage":{"$ref":"#/components/schemas/Coverage"},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["items","count","next_cursor","filters","message"],"additionalProperties":false},"StakeholderBrief":{"$id":"#/components/schemas/StakeholderBrief","type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"name":{"type":"string"},"respondent_category":{"type":"string","enum":["company","business-association","ngo","interest-group","trade-union","public-authority","academic","citizen","other"]}},"required":["id","name","respondent_category"],"additionalProperties":false},"StakeholderResponseItem":{"$id":"#/components/schemas/StakeholderResponseItem","type":"object","properties":{"id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"$ref":"#/components/schemas/FileId"}]},"entity_type":{"$ref":"#/components/schemas/EntityType"},"source":{"$ref":"#/components/schemas/SourceSlug"},"source_name":{"type":"string","description":"The source's display name, the attribution to cite."},"jurisdiction":{"$ref":"#/components/schemas/JurisdictionId"},"authority":{"description":"Publisher, organiser or council, by name.","type":["string","null"]},"authority_id":{"anyOf":[{"$ref":"#/components/schemas/EntityId"},{"type":"null"}]},"title":{"type":["string","null"]},"date":{"anyOf":[{"$ref":"#/components/schemas/DayOrDateTime"},{"type":"null"}]},"document_type":{"anyOf":[{"type":"string","enum":["bill-text","bill-text.introduced","bill-text.amended","bill-text.adopted","explanatory-memorandum","committee-report","amendment","question","answer","letter","memo","report","transcript","agenda","agenda.supplementary","minutes","resolution-text","consultation-document","consultation-response","consultation-memo","consultation-list","legal-act","legal-act.consolidated","annex","eu-document","press-release","audit-report","remarks","procurement-notice","procurement-notice.planning","procurement-notice.competition","procurement-notice.direct-award","procurement-notice.result","procurement-notice.modification","procurement-notice.change","procurement-notice.completion","ruling","other"]},{"type":"null"}]},"document_type_label":{"type":["string","null"]},"document_type_native":{"type":["string","null"]},"reference":{"description":"The source's reference number (case number, bill number).","type":["string","null"]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}],"description":"The official page or file to cite; never a stored copy."},"source_url_missing":{"description":"Localised reason when `source_url` is null (e.g. a newsletter has no public page).","type":["string","null"]},"fetched_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]},"excerpt":{"description":"Where the query matched: escaped HTML with hits in `<b>`; plain text over MCP.","type":["string","null"]},"summary":{"description":"Machine-written summary, when one exists.","type":["string","null"]},"status_text":{"description":"Machine-written one-line status, when one exists.","type":["string","null"]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"The page of the excerpt."},"linked_from":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["name","source_url"],"additionalProperties":false},{"type":"null"}]},"removed_at_source":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}],"description":"When the source removed it; null while live."},"consultation_id":{"$ref":"#/components/schemas/EntityId"},"consultation_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]},"document_title":{"type":["string","null"]},"no_comments":{"type":["boolean","null"]},"position":{"anyOf":[{"type":"string","enum":["supports","opposes","mixed","no_comments","unclear"]},{"type":"null"}],"description":"Machine-read unless `no_comments`."},"position_label":{"type":["string","null"]},"main_points":{"type":"array","items":{"type":"string"},"description":"Quotes from the response."}},"required":["id","entity_type","source","source_name","jurisdiction","authority","authority_id","title","date","document_type","document_type_label","document_type_native","reference","source_url","source_url_missing","fetched_at","excerpt","summary","status_text","page","linked_from","removed_at_source","consultation_id","consultation_url","document_title","no_comments","position","position_label","main_points"],"additionalProperties":false},"InfluenceExample":{"$id":"#/components/schemas/InfluenceExample","type":"object","properties":{"consultation_id":{"$ref":"#/components/schemas/EntityId"},"consultation_title":{"type":"string"},"date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"authority":{"type":["string","null"]},"text":{"type":"string","description":"Verbatim excerpt of the memo, at most 500 characters."},"role":{"type":"string","enum":["proposed","supported","mentioned"]},"explicit":{"type":"boolean","description":"The memo itself credits the organisation."},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["consultation_id","consultation_title","date","authority","text","role","explicit","source_url","page"],"additionalProperties":false},"Influence":{"$id":"#/components/schemas/Influence","type":"object","properties":{"consultations_answered":{"type":"integer","minimum":0,"maximum":9007199254740991},"consultations_with_memo":{"type":"integer","minimum":0,"maximum":9007199254740991},"consultations_with_change":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes_explicit":{"type":"integer","minimum":0,"maximum":9007199254740991},"share":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"per_year":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"consultations":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"changes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["year","consultations","changes"],"additionalProperties":false}},"per_authority":{"type":"array","items":{"type":"object","properties":{"authority":{"type":"string"},"consultations":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"changes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["authority","consultations","changes"],"additionalProperties":false}},"examples":{"type":"array","items":{"$ref":"#/components/schemas/InfluenceExample"}},"explanation":{"type":"string","description":"Localised: 'tied to a change', not 'got it through'."}},"required":["consultations_answered","consultations_with_memo","consultations_with_change","changes","changes_explicit","share","per_year","per_authority","examples","explanation"],"additionalProperties":false,"description":"Changes the consultation memos tie to the organisation; null before memos are read."},"StakeholderProfileResponse":{"$id":"#/components/schemas/StakeholderProfileResponse","type":"object","properties":{"item":{"$ref":"#/components/schemas/StakeholderItem"},"message":{"type":["string","null"]},"coverage":{"$ref":"#/components/schemas/Coverage"},"quota":{"$ref":"#/components/schemas/Quota"},"aliases":{"type":"array","items":{"type":"string"}},"distribution":{"type":"object","properties":{"authority":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["value","count"],"additionalProperties":false}},"subject":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["value","count"],"additionalProperties":false}},"year":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["value","count"],"additionalProperties":false}}},"required":["authority","subject","year"],"additionalProperties":false},"positions":{"type":"object","properties":{"supports":{"type":"integer","minimum":0,"maximum":9007199254740991},"opposes":{"type":"integer","minimum":0,"maximum":9007199254740991},"mixed":{"type":"integer","minimum":0,"maximum":9007199254740991},"no_comments":{"type":"integer","minimum":0,"maximum":9007199254740991},"unclear":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["supports","opposes","mixed","no_comments","unclear"],"additionalProperties":false},"invited":{"anyOf":[{"type":"object","properties":{"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"answered":{"type":"integer","minimum":0,"maximum":9007199254740991},"response_rate":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]}},"required":["count","answered","response_rate"],"additionalProperties":false},{"type":"null"}]},"often_with":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"stakeholder":{"$ref":"#/components/schemas/StakeholderBrief"},"shared_consultations":{"type":"integer","minimum":0,"maximum":9007199254740991},"latest":{"type":"array","items":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/EntityId"},"title":{"type":"string"},"date":{"anyOf":[{"$ref":"#/components/schemas/Day"},{"type":"null"}]},"source_url":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]}},"required":["id","title","date","source_url"],"additionalProperties":false}}},"required":["stakeholder","shared_consultations","latest"],"additionalProperties":false}},"latest_responses":{"type":"array","items":{"$ref":"#/components/schemas/StakeholderResponseItem"}},"next_cursor":{"type":["string","null"]},"influence":{"anyOf":[{"$ref":"#/components/schemas/Influence"},{"type":"null"}]}},"required":["item","message","aliases","distribution","positions","invited","often_with","latest_responses","next_cursor","influence"],"additionalProperties":false},"TrendItem":{"$id":"#/components/schemas/TrendItem","type":"object","properties":{"term":{"type":"string"},"key":{"type":"string","description":"The normalised term the counts are keyed on."},"term_type":{"type":"string","enum":["word","acronym","eu","law","name"]},"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"baseline":{"type":"number","minimum":0},"factor":{"type":["number","null"]},"new":{"type":"boolean"},"score":{"type":"number"},"breadth":{"type":"integer","minimum":0,"maximum":9007199254740991},"baseline_breadth":{"type":"number","minimum":0},"authorities":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"$ref":"#/components/schemas/SourceSlug"},"count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["source","count"],"additionalProperties":false}},"examples":{"maxItems":3,"type":"array","items":{"$ref":"#/components/schemas/Item"}}},"required":["term","key","term_type","count","baseline","factor","new","score","breadth","baseline_breadth","authorities","sources","examples"],"additionalProperties":false},"TrendPeriod":{"$id":"#/components/schemas/TrendPeriod","type":"object","properties":{"kind":{"type":"string","enum":["week","month"]},"from":{"$ref":"#/components/schemas/Day"},"to":{"$ref":"#/components/schemas/Day"},"baseline_from":{"$ref":"#/components/schemas/Day"},"baseline_to":{"$ref":"#/components/schemas/Day"},"computed_at":{"anyOf":[{"$ref":"#/components/schemas/DateTime"},{"type":"null"}]}},"required":["kind","from","to","baseline_from","baseline_to","computed_at"],"additionalProperties":false},"TrendsResponse":{"$id":"#/components/schemas/TrendsResponse","type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/TrendItem"}},"count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Items on this page."},"next_cursor":{"type":["string","null"]},"filters":{"$ref":"#/components/schemas/Filters"},"message":{"description":"Localised; repeat it verbatim when `items` is empty.","type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"},"period":{"$ref":"#/components/schemas/TrendPeriod"},"explanation":{"type":"string"}},"required":["items","count","next_cursor","filters","message","period","explanation"],"additionalProperties":false},"TrendTermResponse":{"$id":"#/components/schemas/TrendTermResponse","type":"object","properties":{"term":{"type":"string"},"key":{"type":["string","null"]},"term_type":{"anyOf":[{"type":"string","enum":["word","acronym","eu","law","name"]},{"type":"null"}]},"group_by":{"type":"string","enum":["week","month"]},"points":{"type":"array","items":{"type":"object","properties":{"from":{"$ref":"#/components/schemas/Day"},"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"breadth":{"type":"integer","minimum":0,"maximum":9007199254740991},"documents_total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["from","count","breadth","documents_total"],"additionalProperties":false}},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"$ref":"#/components/schemas/SourceSlug"},"count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["source","count"],"additionalProperties":false}},"authorities":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"authority":{"type":"string"},"count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["authority","count"],"additionalProperties":false}},"filters":{"$ref":"#/components/schemas/Filters"},"explanation":{"type":"string"},"message":{"description":"Localised; set when the term is not found.","type":["string","null"]},"quota":{"$ref":"#/components/schemas/Quota"}},"required":["term","key","term_type","group_by","points","total","sources","authorities","filters","explanation","message"],"additionalProperties":false}}}}