Tingsnytt
Meny

Tingsnytts API

Förhandlingar i Sveriges tingsrätter, domstolar, registret över brott och måltyper, nyheter och statistik som JSON. Samma API används av Tingsnytts egna appar. Version 1.0.0.

Kom igång

Varje anrop behöver en API-nyckel i rubriken Authorization. Nycklar delas ut av Tingsnytt. Nyckeln är personlig: lägg den inte i kod som körs i en webbläsare.

curl

curl "https://tingsnytt.se/v1/forhandlingar?lan=skane&fran=2026-11-16&till=2026-11-22&maltyp=brottmal" \ -H "Authorization: Bearer DIN_NYCKEL"

JavaScript

const svar = await fetch("https://tingsnytt.se/v1/forhandlingar?lan=skane&fran=2026-11-16&till=2026-11-22&maltyp=brottmal", { headers: { Authorization: "Bearer " + process.env.TINGSNYTT_NYCKEL }, }); if (!svar.ok) throw new Error((await svar.json()).fel.meddelande); const data = await svar.json(); console.log(data.preliminar_text); for (const f of data.forhandlingar) { console.log(f.datum, f.starttid, f.domstol.namn, f.mal.malnummer, f.mal.saken); }

Regler för den som visar uppgifterna

Tiderna är preliminära. Varje svar med förhandlingar har fälten preliminar (alltid true), preliminar_text och senast_inlast per domstol. Visa texten tillsammans med förhandlingarna: “Tiderna är preliminära. Förhandlingar kan ställas in med kort varsel och andra kan tillkomma. Kontakta domstolen för aktuell information.”

Saken är inte en dom. Saken säger vad en förhandling gäller, inte vad någon har gjort. Skriv åtal, misstanke och förhandling, aldrig att någon har begått ett brott.

Borttagen är inte inställd. Status borttagen_ur_listan betyder att förhandlingen inte längre finns i domstolens lista. Listan säger inte varför.

Det som inte får lyftas fram. Mål och poster med far_lyftas_fram: false (familjemål och mål som gäller brott mot barn) får visas i en domstols lista, men aldrig i topplistor, urval, notiser, nyhetsbrev eller liknande.

Nyheter har en källa. Visa alltid källans namn och länken till originalet. För medier finns bara Tingsnytts egen rubrik och ingress, aldrig källans text.

Format, sidor och gränser

Svaren är JSON med svenska fältnamn utan å, ä och ö. Datum skrivs 2026-11-19, klockslag 09:00 i svensk tid, och tidpunkter med tidszon: 2026-11-19T09:00:00+01:00.

Sidor. Listor ger högst 200 rader per anrop (parametern antal). Finns det fler har svaret en markör i nasta_markor: skicka den som parametern markor för nästa sida. När den är null är listan slut.

Gränser. Varje nivå har en gräns per minut och en per dygn. Rubrikerna X-RateLimit-Remaining-Minute och X-RateLimit-Remaining-Day visar vad som är kvar. Över gränsen svarar API:et 429 med rubriken Retry-After i sekunder.

NivåPer minutPer dygn
Gratis10500
Bas605000
Plus30050000
Stor1200500000

Fel. Ett fel har alltid formen { "fel": { "kod": "...", "meddelande": "..." } }. 400 för en okänd eller felskriven parameter, 401 för saknad eller ogiltig nyckel, 403 för en spärrad nyckel, 404 för det som inte finns, 429 över gränsen.

Versioner. Versionen ligger i adressen. Nya fält kan läggas till i /v1, så räkna inte med att ett svar bara har de fält som finns i dag. En ändring som skulle bryta en befintlig användare görs aldrig i /v1: den kommer i /v2.

Domstolar

GET /v1/domstolar

Alla domstolar. Alla aktiva domstolar med kontaktuppgifter och när deras lista senast lästes in.

ParameterTypBeskrivning
lantextBara domstolar i länet. Hovrätterna täcker flera län och kommer inte med.
domstolstyptextBara domstolar av den typen.Värden: tingsratt, hovratt.

Exempel

curl "https://tingsnytt.se/v1/domstolar?lan=skane" \ -H "Authorization: Bearer DIN_NYCKEL"

Fält i svaret

domstolar (lista). Alla fält med beskrivningar står i specifikationen.

GET /v1/domstolar/{slug}

En domstol.

ParameterTypBeskrivning
slugi adressentextDomstolens namn i adresser.

Exempel

curl "https://tingsnytt.se/v1/domstolar/malmo-tingsratt" \ -H "Authorization: Bearer DIN_NYCKEL"

Fält i svaret

domstol. Alla fält med beskrivningar står i specifikationen.

GET /v1/lan

Alla län. Sveriges 21 län med sina domstolar.

Exempel

curl "https://tingsnytt.se/v1/lan" \ -H "Authorization: Bearer DIN_NYCKEL"

Fält i svaret

lan (lista). Alla fält med beskrivningar står i specifikationen.

Förhandlingar

GET /v1/forhandlingar

Förhandlingar. Förhandlingar i ordning efter datum och tid. Utan fran och uppdaterad_efter börjar listan i dag. Tiderna är preliminära: visa alltid preliminar_text tillsammans med förhandlingarna.

ParameterTypBeskrivning
domstoltextBara den domstolen.
lantextBara domstolar i länet.
domstolstyptextBara domstolar av den typen. Utan parametern kommer alla domstolar med.Värden: tingsratt, hovratt.
frandatumFrån och med datumet.
tilldatumTill och med datumet.
maltyptextBara den måltypen.Värden: brottmal, tvistemal, forenklat-tvistemal, konkurs, arende, overklagat-beslut, mark-och-miljomal, patent-och-marknadsmal, ovrigt.
brotttextBara mål där posten ingår i saken.
typtextBara den typen av förhandling.Värden: huvudforhandling, fortsatt-huvudforhandling, muntlig-forberedelse, muntlig-forberedelse-och-huvudforhandling, muntlig-forhandling, sammantrade, konkursforhandling, edgangssammantrade, bevisupptagning, haktningsforhandling.
sakerhetssaltrue eller falsetrue för bara förhandlingar i säkerhetssal, false för bara övriga.
uppdaterad_eftertidpunktBara förhandlingar i mål vars uppgifter ändrats efter tidpunkten. För den som håller en egen kopia aktuell.
antalheltalAntal rader per anrop, 1 till 200. Utan värde 50.
markortextMarkören från föregående svars nasta_markor, för att hämta nästa sida.

Exempel

curl "https://tingsnytt.se/v1/forhandlingar?lan=skane&fran=2026-11-16&till=2026-11-22&maltyp=brottmal" \ -H "Authorization: Bearer DIN_NYCKEL"

Fält i svaret

preliminar, preliminar_text, senast_inlast (lista), forhandlingar (lista), nasta_markor. Alla fält med beskrivningar står i specifikationen.

GET /v1/mal/{domstol}/{malnummer}

Ett mål. Ett mål med alla sina förhandlingar och de nyheter som är kopplade till det. Målnumret skrivs som i adresserna på sajten: b-1234-26. Fältet instanser säger vilket mål i en annan instans som är samma sak, när en lista eller en nyhet uttryckligen anger det.

ParameterTypBeskrivning
domstoli adressentextDomstolens namn i adresser.
malnummeri adressentextMålnumret med små bokstäver och bindestreck.

Exempel

curl "https://tingsnytt.se/v1/mal/malmo-tingsratt/b-1234-26" \ -H "Authorization: Bearer DIN_NYCKEL"

Fält i svaret

preliminar, preliminar_text, senast_inlast (lista), mal, forhandlingar (lista), nyheter (lista), instanser (lista). Alla fält med beskrivningar står i specifikationen.

Brott

GET /v1/brott

Registret över brott och måltyper. Alla godkända poster. Texterna beskriver vad lagen säger i allmänhet, aldrig ett enskilt mål.

ParameterTypBeskrivning
typtextBara poster av den typen.Värden: brott, tvist, konkurs, arende, familjemal.

Exempel

curl "https://tingsnytt.se/v1/brott?typ=brott" \ -H "Authorization: Bearer DIN_NYCKEL"

Fält i svaret

brott (lista). Alla fält med beskrivningar står i specifikationen.

GET /v1/brott/{slug}

En post i registret.

ParameterTypBeskrivning
slugi adressentextPostens namn i adresser.

Exempel

curl "https://tingsnytt.se/v1/brott/stold" \ -H "Authorization: Bearer DIN_NYCKEL"

Fält i svaret

brott. Alla fält med beskrivningar står i specifikationen.

Nyheter

GET /v1/nyheter

Nyheter. Publicerade nyheter, den senaste först. Källan och länken till originalet ska alltid visas. För medier finns aldrig källans text, bara Tingsnytts rubrik och ingress.

ParameterTypBeskrivning
lantextBara nyheter som gäller länet.
domstoltextBara nyheter som gäller domstolen.
brotttextBara nyheter som handlar om posten.
frandatumPublicerade från och med datumet.
antalheltalAntal rader per anrop, 1 till 200. Utan värde 50.
markortextMarkören från föregående svars nasta_markor, för att hämta nästa sida.

Exempel

curl "https://tingsnytt.se/v1/nyheter?lan=skane&fran=2026-11-01" \ -H "Authorization: Bearer DIN_NYCKEL"

Fält i svaret

nyheter (lista), nasta_markor. Alla fält med beskrivningar står i specifikationen.

Statistik

GET /v1/statistik/brott

Vanligaste brotten en vecka. Antal mål med förhandling under veckan där brottet ingår i saken. Poster och mål som inte får lyftas fram räknas inte med.

ParameterTypBeskrivning
lantextBara mål vid domstolar i länet.
veckatextVeckan, skriven som år och veckonummer. Utan värde den aktuella veckan.

Exempel

curl "https://tingsnytt.se/v1/statistik/brott?lan=skane&vecka=2026-v47" \ -H "Authorization: Bearer DIN_NYCKEL"

Fält i svaret

vecka, fran, till, lan, brott (lista). Alla fält med beskrivningar står i specifikationen.

Podd

GET /v1/podd

Poddavsnitt. Publicerade avsnitt, det senaste först.

Exempel

curl "https://tingsnytt.se/v1/podd" \ -H "Authorization: Bearer DIN_NYCKEL"

Fält i svaret

avsnitt (lista). Alla fält med beskrivningar står i specifikationen.