Pilot i Stockholms län

Kommunala dokument. Ett API.

Hämta original, läs normaliserad text och bygg AI-tjänster utan att integrera mot varje kommuns publiceringssystem.

Dokumenthämtning
Beta-API 
# 1. Hitta möten
GET /v1/kommun/municipalities/{code}/meetings

# 2. Lista mötets dokument
GET /v1/kommun/municipalities/{code}/documents?meeting_identifier={meetingIdentifier}

# 3. Läs sidindelad text
GET /v1/kommun/documents/{code}/text?source_identifier={sourceIdentifier}

Betan är tillgänglig för en aktiverad kommun och använder din vanliga APIverket-nyckel.

26

kommuner i Stockholms län har validerats för handlingar från kommunfullmäktige.

  • Ciceron
  • OpenGov
  • Meetings Plus
  • Netpublicator
  • Webbpublicering

Ett gemensamt API

26 kommuner. Flera system. Ett kontrakt.

Kommunala handlingar publiceras i olika system, filformat och webbflöden. I dag behöver du förstå varje kommuns tekniska lösning innan du kan läsa det första dokumentet.

APIverket Kommun ger dig ett gemensamt REST-kontrakt ovanpå skillnaderna. Kommunens system förblir originalkälla. APIverket hanterar resten när dokumentet hämtas.

Du ska kunna hitta, hämta och läsa kommunala dokument utan att känna till kommunens publiceringssystem eller webbstruktur.

API-kontrakt i beta

Från text tillbaka till originalet

Svaret är gjort för maskiner, men varje textsida går fortfarande att spåra till kommunens original.

GET · normaliserad text
Beta 
GET /v1/kommun/documents/{code}/text?source_identifier={sourceIdentifier}
Authorization: Bearer YOUR_API_KEY

{
  "id": "<beständigt-id>",
  "municipality_code": "<kommunkod>",
  "title": "<handlingens titel>",
  "source_url": "<originalkälla>",
  "sha256": "<checksumma>",
  "page_count": 12,
  "ocr_required": false,
  "segments": [
    {
      "page_start": 1,
      "page_end": 1,
      "text": "...",
      "source_url": "<originalkälla>"
    }
  ],
  "retrieval": {
    "mode": "on_demand",
    "persisted": false
  }
}
  • Beständigt dokument-IDEn stabil referens som du kan spara och återanvända.
  • Original och källhänvisningOriginalfilen och länken till kommunens publicerade källa följer med.
  • Sidnummer och OCR-statusCitera per sida och se direkt om texten har OCR-tolkats.
  • ChecksummaVerifiera vilken fil texten kommer från.
Betakontrakt

Tillgängligt i piloten. Möteslistning, dokumenthämtning och sidindelad text är aktiverat för en kommun. Kontraktet kan fortfarande utvecklas under betan.

Dokumentets väg

Från originalkälla till spårbart API-svar

Steg 1 av 4

Originalet finns kvar hos kommunen

Kommunens publiceringssystem är fortfarande originalkällan. Källhänvisningen följer med i API-svaret.

Kommunens publiceringssystem

Användningsfall

Bygg ovanpå handlingarna, inte portalerna

För dig som vill använda dokumentens innehåll och källor i en egen tjänst eller ett eget arbetsflöde.

AI-assistenter och söktjänster

Ge AI-system sidindelad text, källor och OCR-status utan att de behöver tolka varje kommunwebb.

Journalistik och granskning

Hämta handlingar på ett reproducerbart sätt och koppla varje citat till rätt sida och originalfil.

Civic tech och offentlig data

Bygg bevakning, jämförelser och lokala tjänster med ett gemensamt dokumentformat.

Leverantörer till offentlig sektor

Slipp separata integrationer när kommunala handlingar ska in i en produkt eller ett arbetsflöde.

Pilotstatus

26 validerade kommunkällor. En kommun i den körbara betan.

  • Vi har validerat källorna för alla 26 kommuner i Stockholms län.
  • Den körbara betan är just nu aktiverad för Solnas kommunfullmäktige.
  • Alla dokumenttyper, historiska perioder och nämnder täcks inte ännu.
  • Vi utökar betan källa för källa efter att integration och dokumentkvalitet har verifierats.

Vanliga frågor

Om källor, täckning och användning

Lagrar APIverket alla dokument?

Nej. Dokument hämtas när någon ber om dem. Vi kan behöva mellanlagra filer för att ge dig svaret, men bygger inte ett permanent centralt arkiv.

Ersätter tjänsten kommunens originalkälla?

Nej. Kommunens publiceringssystem är fortfarande originalkällan. Svaret innehåller källhänvisning och verifieringsdata så att du kan gå tillbaka till originalet.

Täcker tjänsten hela Sverige?

Nej. Källorna har validerats för alla 26 kommuner i Stockholms län, men den körbara betan är just nu aktiverad för Solnas kommunfullmäktige. Fler källor läggs till efter verifiering.

Kan API:t användas av AI-system?

Ja, det är ett centralt användningsfall. Betasvaret innehåller sidindelad text, källa, checksumma och OCR-status så att AI-system kan arbeta spårbart.

Ingår fulltextsökning?

Nej, inte i piloten. En separat söktjänst kan komma senare. Basprodukten fokuserar på att hitta, hämta och läsa kända kommunala handlingar.

Pilotåtkomst

Vill du testa med riktiga kommunala handlingar?

Berätta vilka kommuner och handlingar du behöver. Då kan vi snabbt se om de ryms i piloten.

Anmäl intresse Se API-kontraktet