Datan som JSON

Adresser

Registret håller 670 partier. Ett parti som har bytt filnamn svarar 308 på sin gamla adress och pekar på den nuvarande, precis som partisidorna gör.

Fält

Fälten nedan är det en läsare kan räkna med. Ett fält som står som valfritt kan saknas i en enskild post. Nästlade fält skrivs med punktnotation, och [] markerar att föräldern är en lista.

Identiteterna hänger ihop på tre ställen: uuid i registret är samma uuid som i partifilen och samma parti_uuid som i valresultaten; kod är Valmyndighetens PARTIKOD och binder partifilen till partideltagandet; läns- och kommunkoderna är SCB:s och slås upp i regioner/index.json.

2018 års filer ligger kvar som de samlades in och avviker: landsting.json i stället för region.json, inget partier.json, 208 av 290 kommuner, inga grunder, och region- och kommunfilerna listar bara partier som inte står i riksdag.json.

Hämta

curl -i https://www.partidata.se/data/parti/arbetarepartiet-socialdemokraterna/index.json

fetch('https://www.partidata.se/data/parti/arbetarepartiet-socialdemokraterna/index.json')
  .then(response => response.json())
  .then(parti => console.log(parti.beteckning));

Huvuden

• Cache-Control: public, max-age=3600 — datan ändras bara när en ny version driftsätts, så ett svar är som mest en timme gammalt.
• ETag — W/ följt av filens SHA-256. Etaggen är svag därför att samma fil levereras både komprimerad och okomprimerad; det är samma representation, och det är precis vad en svag etagg säger. Skicka tillbaka den oförändrad i If-None-Match och få 304 utan kropp när filen är densamma.
• Vary: Accept-Encoding — kroppen varierar med komprimeringen.
• X-Partidata-Version — den version som svarade, samma nummer som i sidfoten och i /api/health.
• Access-Control-Allow-Origin: * på varje svar, och Access-Control-Expose-Headers: ETag, X-Partidata-Version, så att en webbläsarklient kan läsa båda.

Statuskoder

• 200 — filens byte, som application/json; charset=utf-8.
• 304 — If-None-Match matchar; ingen kropp.
• 308 — adressen använder ett tidigare filnamn; följ Location.
• 404 — adressen betecknar ingen publicerad resurs. Kroppen är {"fel":"Okänd resurs"}.
• 405 — bara GET, HEAD och OPTIONS är tillåtna; svaret bär Allow.
• 204 — svaret på OPTIONS, med de tillåtna metoderna.

Versionering

• Adresser och fältnamn är stabila. Nya fält kan tillkomma utan förvarning — en läsare ska ignorera fält den inte känner igen.
• Datan ändras bara när en ny version driftsätts. Versionen står i X-Partidata-Version, i sidfoten och i /api/health, och samma filer finns på GitHub under taggen.
• Ett fält eller en adress som tas bort eller döps om görs i en version som noteras här, och en flyttad adress vidarebefordras med 308 när det går — som ett parti som har bytt filnamn.

Licens och villkor

Partidatas egen sammanställning — strukturen, uuid, filnamn, de härledda fälten och allt under derived/ — är CC0 1.0. Uppgifterna kommer från källor med egna villkor, och kalla, kallurl och kallor i filerna anger källan per post. Villkoren nedan är kontrollerade 2026-08-30.

• Valmyndigheten — partibeteckningar, deltagande och valresultat. All data är fri att använda, förutsatt att du anger Valmyndigheten som källa. Om Valmyndighetens öppna data
• SCB — läns- och kommunkoder samt valdeltagande. CC0, utan krav på källhänvisning, men SCB rekommenderar ändå "Källa: SCB". SCB:s öppna data
• Wikidata — wikidata.grundat. CC0. Wikidatas licensvillkor

Partisymbolerna serveras inte under /data/. De kommer från Valmyndighetens symbolpaket och kan vara varumärkesskyddade — villkoren för att använda dem är partiets, inte Partidatas.

Det som inte finns här

• Kandidatlistor — val/<år>/kandidatlistor/ innehåller personuppgifter och serveras inte. Hur de ska hanteras avgörs i issue 33.
• Partisymboler — PNG-filerna ligger i partiets katalog och serveras på /partisymbol/<filnamn>/<partisymbol.filnamn>, inte under /data/.
• Profildata — parti/<filnamn>/profil.json bär utdrag ur Wikipedia under CC BY-SA 4.0 och nyhetsrubriker, och finns bara på GitHub.
• Kopplingstabeller — parti/kodbyten.json, valresultat/riksdag-partikopplingar.json och val/<år>/valresultat/scb-tabeller.json är arbetsmaterial för importen och finns på GitHub.