{"id":"postlister","name":"Norwegian public correspondence journals","description":"Search municipal and central-government correspondence journals and public case metadata.","documentation":"https://norske-postlister.no/","operations":[{"name":"search","description":"Search Norwegian public mail journals (postlister).","parameters":[{"name":"query","type":"string","schema":{"type":"string"},"display_type":"string","required":false,"default":"*","description":"Lucene query-string over all fields. A bare word searches everything (e.g. \"Equinor\", \"byggesak\"). Field-scoped and range queries work too, e.g. `document_title:skole`, `document_type:\"Inng\u00e5ende brev\"`, `document_from_org.orgnummer:923609016`. Default \"*\" matches everything (combine with filters)."},{"name":"entity_id","type":"string","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"display_type":"string","required":false,"default":null,"description":"Restrict to one authority, e.g. \"2012-alta-kommune\". Read it off `entity_id` in earlier results."},{"name":"date_from","type":"string","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"display_type":"string","required":false,"default":null,"description":"Document-date lower bound, ISO \"YYYY-MM-DD\" (inclusive)."},{"name":"date_to","type":"string","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"display_type":"string","required":false,"default":null,"description":"Document-date upper bound, ISO \"YYYY-MM-DD\" (inclusive)."},{"name":"limit","type":"integer","schema":{"type":"integer"},"display_type":"integer","required":false,"default":20,"description":"Max documents to return, 1 to 100 (default 20)."},{"name":"offset","type":"integer","schema":{"type":"integer","minimum":0,"default":0},"display_type":"integer","required":false,"default":0,"description":"Number of list items to skip before returning the page."}],"json_get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/postlister/search?query=%2A&entity_id={entity_id}&date_from={date_from}&date_to={date_to}&limit=20&offset=0","output_fields":["total_hits","returned","capped","documents"],"output_fields_truncated":false,"canonical_field_aliases":{},"description_language":"en","documentation":"Search Norwegian public mail journals (postlister).\n\nA result's `document_date` (the date on the document) is null when the\nsource authority does not publish it; `recorded_date` (when the journal\nregistered the document) is then the only date. `date_from`/`date_to`\nfilter on `document_date`, so documents that lack it are excluded from a\ndated search even when recently journalled.\n\nArgs:\n    query: Lucene query-string over all fields. A bare word searches\n        everything (e.g. \"Equinor\", \"byggesak\"). Field-scoped and range\n        queries work too, e.g. `document_title:skole`,\n        `document_type:\"Inng\u00e5ende brev\"`,\n        `document_from_org.orgnummer:923609016`.\n        Default \"*\" matches everything (combine with filters).\n    entity_id: Restrict to one authority, e.g. \"2012-alta-kommune\".\n        Read it off `entity_id` in earlier results.\n    date_from: Document-date lower bound, ISO \"YYYY-MM-DD\" (inclusive).\n    date_to: Document-date upper bound, ISO \"YYYY-MM-DD\" (inclusive).\n    limit: Max documents to return, 1 to 100 (default 20).\n\nReturns `total_hits` (all matches upstream), `returned`, `capped`\n(True when there are more than the 100 upstream will ever return), and\n`documents`. Each document has entity, case/document titles and ids,\ndates, from/to (parties and matched orgs), a `case_url` for drill-down,\nand any attached `files`.","documentation_language":"en","wiki_get_endpoint":"https://allemannsdata.com/wiki/kilder/postlister/search/","wiki_get_url_template":"https://allemannsdata.com/wiki/kilder/postlister/search/?query=%2A&entity_id={entity_id}&date_from={date_from}&date_to={date_to}&limit=20&offset=0","json_endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/postlister/search","response_schema":{"type":"object","properties":{"total_hits":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"returned":{"type":["integer","null"]},"capped":{"type":"boolean"},"documents":{"type":"array","items":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."}}},"additionalProperties":false},"response_schema_status":{"status":"incomplete","codegen_safe":false,"description":"Not suitable for typed model generation: the container shape and field names are useful, but unresolved values accept any JSON value."},"entity_projection":{"status":"projected","entity_types":["public_record"],"description":"Recognized records and stable operation identifiers are projected; an empty array means the successful payload contained no recognizable entity."},"response_schema_url":"https://allemannsdata.com/wiki/api/v1/kilder/postlister/search/schema","endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/postlister/search","get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/postlister/search?query=%2A&entity_id={entity_id}&date_from={date_from}&date_to={date_to}&limit=20&offset=0"},{"name":"search_kommune","description":"Search one municipality's (or agency's) mail journal, optionally by time range.","parameters":[{"name":"kommune","type":"string","schema":{"type":"string"},"display_type":"string","required":true,"default":null,"description":"The authority. Either its name, e.g. \"Alta\", \"Bergen kommune\" (slugified into an entity_id filter), or an exact entity_id, e.g. \"2012-alta-kommune\". If a name returns nothing, the authority may use a historical slug (e.g. Nesbyen is \"nes-i-buskerud-kommune\"); run a plain search() and read the entity_id off a result."},{"name":"date_from","type":"string","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"display_type":"string","required":false,"default":null,"description":"Document-date lower bound, ISO \"YYYY-MM-DD\" (inclusive)."},{"name":"date_to","type":"string","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"display_type":"string","required":false,"default":null,"description":"Document-date upper bound, ISO \"YYYY-MM-DD\" (inclusive)."},{"name":"query","type":"string","schema":{"type":"string"},"display_type":"string","required":false,"default":"*","description":"Optional extra Lucene text to narrow within the municipality, e.g. \"byggesak\" or `document_title:skole`. Default \"*\" (everything)."},{"name":"limit","type":"integer","schema":{"type":"integer"},"display_type":"integer","required":false,"default":20,"description":"Max documents to return, 1 to 100 (default 20)."},{"name":"offset","type":"integer","schema":{"type":"integer","minimum":0,"default":0},"display_type":"integer","required":false,"default":0,"description":"Number of list items to skip before returning the page."}],"json_get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/postlister/search_kommune?kommune={kommune}&date_from={date_from}&date_to={date_to}&query=%2A&limit=20&offset=0","output_fields":["total_hits","returned","capped","documents","note","coverage_latest"],"output_fields_truncated":false,"canonical_field_aliases":{},"description_language":"en","documentation":"Search one municipality's (or agency's) mail journal, optionally by time range.\n\n`date_from`/`date_to` filter on each document's `document_date`; documents\nwhose source authority does not publish that date (it comes back null) are\nexcluded from a dated search even if recently journalled (`recorded_date`).\n\nArgs:\n    kommune: The authority. Either its name, e.g. \"Alta\", \"Bergen kommune\"\n        (slugified into an entity_id filter), or an exact entity_id, e.g.\n        \"2012-alta-kommune\". If a name returns nothing, the authority may use\n        a historical slug (e.g. Nesbyen is \"nes-i-buskerud-kommune\"); run a\n        plain search() and read the entity_id off a result.\n    date_from: Document-date lower bound, ISO \"YYYY-MM-DD\" (inclusive).\n    date_to: Document-date upper bound, ISO \"YYYY-MM-DD\" (inclusive).\n    query: Optional extra Lucene text to narrow within the municipality,\n        e.g. \"byggesak\" or `document_title:skole`. Default \"*\" (everything).\n    limit: Max documents to return, 1 to 100 (default 20).\n\nReturns the same shape as search(). When a dated search comes back empty it\nalso carries a `note`, and a `coverage_latest` date if the authority has any\ndocuments at all, so a caller can tell \"stopped publishing\" from a bad slug\nand stop retrying dates. Note the 100-hit upstream cap: for a busy\nmunicipality over a wide range, narrow `query` or the dates.","documentation_language":"en","wiki_get_endpoint":"https://allemannsdata.com/wiki/kilder/postlister/search_kommune/","wiki_get_url_template":"https://allemannsdata.com/wiki/kilder/postlister/search_kommune/?kommune={kommune}&date_from={date_from}&date_to={date_to}&query=%2A&limit=20&offset=0","json_endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/postlister/search_kommune","response_schema":{"type":"object","properties":{"total_hits":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"returned":{"type":["integer","null"]},"capped":{"type":"boolean"},"documents":{"type":"array","items":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."}},"note":{"type":"string"},"coverage_latest":{"anyOf":[{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},{"type":"null"}]}},"additionalProperties":false},"response_schema_status":{"status":"incomplete","codegen_safe":false,"description":"Not suitable for typed model generation: the container shape and field names are useful, but unresolved values accept any JSON value."},"entity_projection":{"status":"projected","entity_types":["public_record"],"description":"Recognized records and stable operation identifiers are projected; an empty array means the successful payload contained no recognizable entity."},"response_schema_url":"https://allemannsdata.com/wiki/api/v1/kilder/postlister/search_kommune/schema","endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/postlister/search_kommune","get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/postlister/search_kommune?kommune={kommune}&date_from={date_from}&date_to={date_to}&query=%2A&limit=20&offset=0"},{"name":"get_case","description":"List all documents belonging to one case (sak).","parameters":[{"name":"entity_id","type":"string","schema":{"type":"string"},"display_type":"string","required":true,"default":null,"description":"The authority, e.g. \"2012-alta-kommune\"."},{"name":"case_serial_number","type":"string","schema":{"type":"string"},"display_type":"string","required":true,"default":null,"description":"The case number \"YEAR/SERIAL\", e.g. \"2026/5822\" (the `case_serial_number` field from search results)."},{"name":"limit","type":"integer","schema":{"type":"integer"},"display_type":"integer","required":false,"default":100,"description":"Max documents to return, 1 to 100 (default 100)."},{"name":"offset","type":"integer","schema":{"type":"integer","minimum":0,"default":0},"display_type":"integer","required":false,"default":0,"description":"Number of list items to skip before returning the page."}],"json_get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/postlister/get_case?entity_id={entity_id}&case_serial_number={case_serial_number}&limit=100&offset=0","output_fields":["total_hits","returned","capped","documents"],"output_fields_truncated":false,"canonical_field_aliases":{},"description_language":"en","documentation":"List all documents belonging to one case (sak).\n\nArgs:\n    entity_id: The authority, e.g. \"2012-alta-kommune\".\n    case_serial_number: The case number \"YEAR/SERIAL\", e.g. \"2026/5822\"\n        (the `case_serial_number` field from search results).\n    limit: Max documents to return, 1 to 100 (default 100).\n\nReturns the same shape as search(): documents in the case, newest first.","documentation_language":"en","wiki_get_endpoint":"https://allemannsdata.com/wiki/kilder/postlister/get_case/","wiki_get_url_template":"https://allemannsdata.com/wiki/kilder/postlister/get_case/?entity_id={entity_id}&case_serial_number={case_serial_number}&limit=100&offset=0","json_endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/postlister/get_case","response_schema":{"type":"object","properties":{"total_hits":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"returned":{"type":["integer","null"]},"capped":{"type":"boolean"},"documents":{"type":"array","items":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."}}},"additionalProperties":false},"response_schema_status":{"status":"incomplete","codegen_safe":false,"description":"Not suitable for typed model generation: the container shape and field names are useful, but unresolved values accept any JSON value."},"entity_projection":{"status":"projected","entity_types":["public_record"],"description":"Recognized records and stable operation identifiers are projected; an empty array means the successful payload contained no recognizable entity."},"response_schema_url":"https://allemannsdata.com/wiki/api/v1/kilder/postlister/get_case/schema","endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/postlister/get_case","get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/postlister/get_case?entity_id={entity_id}&case_serial_number={case_serial_number}&limit=100&offset=0"}],"operation_schema_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/postlister/{operation}/schema","related_sources":[],"_meta":{"retrieved_at":"2026-08-02T14:01:28Z","language":"en","content_languages":["en"],"sources":[{"id":"postlister","name":"Norwegian public correspondence journals","description":"Search municipal and central-government correspondence journals and public case metadata.","documentation":"https://norske-postlister.no/","cache_ttl_seconds":120}]},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/postlister","names":"https://allemannsdata.com/wiki/api/v1/kilder/postlister?view=names","compact":"https://allemannsdata.com/wiki/api/v1/kilder/postlister?view=compact","full":"https://allemannsdata.com/wiki/api/v1/kilder/postlister","wiki":"https://allemannsdata.com/wiki/kilder/postlister/"}}