{ "components": { "schemas": { "Error": { "properties": { "error": { "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "type": "object" } }, "type": "object" }, "Meta": { "properties": { "attribution": { "type": "string" }, "build_run_id": { "type": "integer" }, "built_at": { "format": "date-time", "type": "string" }, "endpoint": { "type": "string" }, "fetched_at": { "format": "date-time", "type": "string" }, "licenses": { "items": { "type": "string" }, "type": "array" }, "sources": { "items": { "type": "object" }, "type": "array" }, "usage_mode": { "type": "string" }, "version": { "type": "integer" } }, "type": "object" } }, "securitySchemes": { "apiKey": { "in": "header", "name": "X-API-Key", "type": "apiKey" }, "bearer": { "scheme": "bearer", "type": "http" } } }, "info": { "contact": { "email": "hello@aleva.se" }, "description": "Public datasets as API endpoints. Every response carries the attribution and licence of its sources in _meta and the X-Attribution header; show the attribution where you use the data.", "title": "Aleva API", "version": "endpoint:air-passengers-monthly:1:true,endpoint:airport-passengers:1:true,endpoint:consumer-prices:1:true,endpoint:court-rulings:1:true,endpoint:court-rulings-by-court:1:true,endpoint:debt-restructuring:1:true,endpoint:debt-restructuring-by-age:1:true,endpoint:domain-lookup:1:true,endpoint:domains-dropped:1:true,endpoint:domains-expiring:1:true,endpoint:domains-new:1:true,endpoint:domains-valuable:1:true,endpoint:electricity-balance:1:true,endpoint:electricity-forecast:1:true,endpoint:foods:1:true,endpoint:guest-nights:1:true,endpoint:guest-nights-by-country:1:true,endpoint:guest-nights-by-county:1:true,endpoint:house-prices:1:true,endpoint:job-ads:1:true,endpoint:job-ads-national:1:true,endpoint:medicine-shortages:1:true,endpoint:medicine-shortages-by-group:1:true,endpoint:medicine-shortages-monthly:1:true,endpoint:municipal-figures:1:true,endpoint:municipal-figures-latest:1:true,endpoint:party-agreement:1:true,endpoint:party-attendance:1:true,endpoint:population:1:true,endpoint:population-latest:1:true,endpoint:riksbank-rates:1:true,endpoint:stats-dnssec:1:true,endpoint:stats-nameservers:1:true,endpoint:swestr:1:true,endpoint:train-punctuality:1:true,endpoint:train-punctuality-daily:1:true,endpoint:weather-history:1:true,endpoint:weather-now:1:true,showcase:aviation:1:true,showcase:debt:1:true,showcase:domains:1:true,showcase:energy:1:true,showcase:expiring-domains:1:true,showcase:foods:1:true,showcase:jobs:1:true,showcase:medicines:1:true,showcase:municipalities:1:true,showcase:rates:1:true,showcase:riksdag:1:true,showcase:rulings:1:true,showcase:sweden:1:true,showcase:tourism:1:true,showcase:trains:1:true,showcase:weather:1:true" }, "openapi": "3.1.0", "paths": { "/v1/aviation/airports": { "get": { "operationId": "airport-passengers", "parameters": [ { "description": "Year equals", "in": "query", "name": "year", "required": false, "schema": { "type": "integer" } }, { "description": "Year at least", "in": "query", "name": "year.gte", "required": false, "schema": { "type": "integer" } }, { "description": "Year at most", "in": "query", "name": "year.lte", "required": false, "schema": { "type": "integer" } }, { "description": "Airport (as reported, upper case) equals", "in": "query", "name": "airport", "required": false, "schema": { "type": "string" } }, { "description": "Airport (as reported, upper case) starts with", "in": "query", "name": "airport.prefix", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "airport": { "type": "string" }, "international_share": { "type": "number" }, "months": { "description": "Months reported (the current year is partial)", "format": "int64", "type": "integer" }, "movements": { "format": "int64", "type": "integer" }, "passengers": { "format": "int64", "type": "integer" }, "year": { "format": "int32", "type": "integer" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Passengers per airport and year", "x-bucket": "airport_passengers", "x-tier": "light" } }, "/v1/aviation/passengers/monthly": { "get": { "operationId": "air-passengers-monthly", "parameters": [ { "description": "Month equals", "in": "query", "name": "month", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Month at least", "in": "query", "name": "month.gte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Month at most", "in": "query", "name": "month.lte", "required": false, "schema": { "format": "date", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 500, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "domestic": { "format": "int64", "type": "integer" }, "international": { "format": "int64", "type": "integer" }, "month": { "format": "date", "type": "string" }, "movements": { "format": "int64", "type": "integer" }, "passengers": { "format": "int64", "type": "integer" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Air passengers in Sweden per month", "x-bucket": "air_passengers_monthly", "x-tier": "light" } }, "/v1/courts/rulings": { "get": { "operationId": "court-rulings", "parameters": [ { "description": "HDO Supreme Court, HFD Supreme Administrative Court, ... equals", "in": "query", "name": "court_code", "required": false, "schema": { "type": "string" } }, { "description": "HDO Supreme Court, HFD Supreme Administrative Court, ... one of (comma-separated)", "in": "query", "name": "court_code.in", "required": false, "schema": { "type": "string" } }, { "description": "Decision day equals", "in": "query", "name": "decided_on", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Decision day at least", "in": "query", "name": "decided_on.gte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Decision day at most", "in": "query", "name": "decided_on.lte", "required": false, "schema": { "format": "date", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "maximum": 500, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "case_numbers": { "type": "string" }, "court": { "type": "string" }, "court_code": { "type": "string" }, "decided_on": { "format": "date", "type": "string" }, "id": { "type": "string" }, "keywords": { "type": "string" }, "kind": { "description": "REFERAT (case report), DOM_ELLER_BESLUT (judgment or decision), ...", "type": "string" }, "laws": { "description": "Provisions cited", "type": "string" }, "published_at": { "format": "date-time", "type": "string" }, "reference": { "description": "Case report number, e.g. NJA 2026:12", "type": "string" }, "summary": { "type": "string" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Published court rulings", "x-bucket": "court_rulings", "x-tier": "standard" } }, "/v1/courts/rulings/by-court": { "get": { "operationId": "court-rulings-by-court", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 100, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "court": { "type": "string" }, "court_code": { "type": "string" }, "latest": { "format": "date", "type": "string" }, "rulings": { "format": "int64", "type": "integer" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Rulings per court", "x-bucket": "court_rulings_by_court", "x-tier": "light" } }, "/v1/domains/dropped": { "get": { "operationId": "domains-dropped", "parameters": [ { "description": "Day (Europe/Stockholm), YYYY-MM-DD equals", "in": "query", "name": "date", "required": true, "schema": { "format": "date", "type": "string" } }, { "description": "Zone: se or nu equals", "in": "query", "name": "tld", "required": false, "schema": { "type": "string" } }, { "description": "Zone: se or nu one of (comma-separated)", "in": "query", "name": "tld.in", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "date": { "description": "Day the change was seen (Europe/Stockholm)", "format": "date", "type": "string" }, "detected_at": { "format": "date-time", "type": "string" }, "domain": { "type": "string" }, "prev_has_ds": { "type": "boolean" }, "prev_nameservers": { "description": "Name servers before the change", "items": { "type": "string" }, "type": "array" }, "serial": { "description": "Serial the change was seen in", "format": "int64", "type": "integer" }, "tld": { "type": "string" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Dropped .se and .nu domains on a date", "x-attribution": "Contains data from the Swedish Internet Foundation (Internetstiftelsen), licensed under CC BY 4.0", "x-bucket": "domain_events_daily", "x-licenses": [ "CC-BY-4.0" ], "x-tier": "light" } }, "/v1/domains/expiring": { "get": { "operationId": "domains-expiring", "parameters": [ { "description": "Zone: se or nu equals", "in": "query", "name": "tld", "required": false, "schema": { "type": "string" } }, { "description": "Zone: se or nu one of (comma-separated)", "in": "query", "name": "tld.in", "required": false, "schema": { "type": "string" } }, { "description": "Release day equals", "in": "query", "name": "release_at", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Release day at least", "in": "query", "name": "release_at.gte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Release day at most", "in": "query", "name": "release_at.lte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Characters before the dot equals", "in": "query", "name": "label_length", "required": false, "schema": { "type": "integer" } }, { "description": "Characters before the dot at most", "in": "query", "name": "label_length.lte", "required": false, "schema": { "type": "integer" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "days_left": { "description": "Days from the list's date to the release date", "format": "int32", "type": "integer" }, "domain": { "type": "string" }, "in_zone": { "description": "Still delegated in the latest zone snapshot", "type": "boolean" }, "label_length": { "description": "Characters before the dot", "format": "int32", "type": "integer" }, "release_at": { "description": "Day it can be registered again (from 04:00 UTC), unless renewed first", "format": "date", "type": "string" }, "tld": { "type": "string" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Domains about to be released", "x-attribution": "Contains data from the Swedish Internet Foundation (Internetstiftelsen), licensed under CC BY 4.0", "x-bucket": "domains_expiring", "x-licenses": [ "CC-BY-4.0" ], "x-tier": "standard" } }, "/v1/domains/expiring/valuable": { "get": { "operationId": "domains-valuable", "parameters": [ { "description": "Days until release at most", "in": "query", "name": "days_left.lte", "required": false, "schema": { "type": "integer" } }, { "description": "Days until release at least", "in": "query", "name": "days_left.gte", "required": false, "schema": { "type": "integer" } }, { "description": "Release day equals", "in": "query", "name": "release_at", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Release day at least", "in": "query", "name": "release_at.gte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Release day at most", "in": "query", "name": "release_at.lte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Minimum score at least", "in": "query", "name": "score.gte", "required": false, "schema": { "type": "integer" } }, { "description": "se or nu equals", "in": "query", "name": "tld", "required": false, "schema": { "type": "string" } }, { "description": "Contains a well-known brand equals", "in": "query", "name": "possible_trademark", "required": false, "schema": { "type": "boolean" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "maximum": 500, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "compound": { "type": "boolean" }, "days_left": { "format": "int32", "type": "integer" }, "domain": { "type": "string" }, "length": { "description": "Characters before the dot", "format": "int32", "type": "integer" }, "possible_trademark": { "description": "Contains a well-known brand: probably not usable", "type": "boolean" }, "reasons_en": { "description": "Why, in English", "type": "string" }, "reasons_sv": { "description": "Why, in Swedish", "type": "string" }, "release_at": { "description": "Day it can be registered again (from 04:00 UTC), unless renewed first", "format": "date", "type": "string" }, "score": { "description": "0-100; higher is shorter, cleaner and closer to real words", "format": "int32", "type": "integer" }, "tld": { "type": "string" }, "word_en": { "type": "boolean" }, "word_sv": { "type": "boolean" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Domains about to be released, with a value score", "x-attribution": "Contains data from the Swedish Internet Foundation (Internetstiftelsen), licensed under CC BY 4.0 SALDO, Språkbanken Text (University of Gothenburg), CC BY 4.0 Word list from SCOWL, copyright Kevin Atkinson (wordlist.aspell.net)", "x-bucket": "domain_values", "x-licenses": [ "CC-BY-4.0", "SCOWL licence (permissive; copyright notice kept)" ], "x-tier": "standard" } }, "/v1/domains/new": { "get": { "operationId": "domains-new", "parameters": [ { "description": "Day (Europe/Stockholm), YYYY-MM-DD equals", "in": "query", "name": "date", "required": true, "schema": { "format": "date", "type": "string" } }, { "description": "Zone: se or nu equals", "in": "query", "name": "tld", "required": false, "schema": { "type": "string" } }, { "description": "Zone: se or nu one of (comma-separated)", "in": "query", "name": "tld.in", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "date": { "description": "Day the change was seen (Europe/Stockholm)", "format": "date", "type": "string" }, "detected_at": { "format": "date-time", "type": "string" }, "domain": { "type": "string" }, "has_ds": { "type": "boolean" }, "nameservers": { "description": "Name servers after the change (empty when removed)", "items": { "type": "string" }, "type": "array" }, "serial": { "description": "Serial the change was seen in", "format": "int64", "type": "integer" }, "tld": { "type": "string" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "New .se and .nu domains on a date", "x-attribution": "Contains data from the Swedish Internet Foundation (Internetstiftelsen), licensed under CC BY 4.0", "x-bucket": "domain_events_daily", "x-licenses": [ "CC-BY-4.0" ], "x-tier": "light" } }, "/v1/domains/{name}": { "get": { "operationId": "domain-lookup", "parameters": [ { "description": "Domain name, e.g. example.se equals", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "properties": { "domain": { "description": "Domain name, lower-case", "type": "string" }, "ds_algorithms": { "description": "DNSSEC algorithm numbers", "items": { "type": "integer" }, "type": "array" }, "fetched_at": { "description": "When the zone was transferred", "format": "date-time", "type": "string" }, "glue_v4": { "description": "In-zone glue A records", "items": { "type": "string" }, "type": "array" }, "glue_v6": { "description": "In-zone glue AAAA records", "items": { "type": "string" }, "type": "array" }, "has_ds": { "description": "DNSSEC signed delegation", "type": "boolean" }, "nameservers": { "description": "NS host names", "items": { "type": "string" }, "type": "array" }, "serial": { "description": "Zone serial the row comes from", "format": "int64", "type": "integer" }, "tld": { "description": "se or nu", "type": "string" } }, "type": "object" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "One domain in the latest zone", "x-attribution": "Contains data from the Swedish Internet Foundation (Internetstiftelsen), licensed under CC BY 4.0", "x-bucket": "domains_current", "x-licenses": [ "CC-BY-4.0" ], "x-tier": "light" } }, "/v1/economy/debt-restructuring": { "get": { "operationId": "debt-restructuring", "parameters": [ { "description": "Month equals", "in": "query", "name": "month", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Month at least", "in": "query", "name": "month.gte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Month at most", "in": "query", "name": "month.lte", "required": false, "schema": { "format": "date", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 500, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "applications": { "format": "int64", "type": "integer" }, "eservice_share": { "description": "Share filed via the e-service", "type": "number" }, "men": { "format": "int64", "type": "integer" }, "month": { "format": "date", "type": "string" }, "women": { "format": "int64", "type": "integer" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Debt restructuring applications per month", "x-bucket": "debt_restructuring_monthly", "x-tier": "light" } }, "/v1/economy/debt-restructuring/by-age": { "get": { "operationId": "debt-restructuring-by-age", "parameters": [ { "description": "Year equals", "in": "query", "name": "year", "required": false, "schema": { "type": "integer" } }, { "description": "Year at least", "in": "query", "name": "year.gte", "required": false, "schema": { "type": "integer" } }, { "description": "Year at most", "in": "query", "name": "year.lte", "required": false, "schema": { "type": "integer" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 500, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "age_group": { "type": "string" }, "applications": { "format": "int64", "type": "integer" }, "year": { "format": "int32", "type": "integer" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Debt restructuring per year and age", "x-bucket": "debt_restructuring_by_age", "x-tier": "light" } }, "/v1/energy/electricity/balance": { "get": { "operationId": "electricity-balance", "parameters": [ { "description": "Year equals", "in": "query", "name": "year", "required": false, "schema": { "type": "integer" } }, { "description": "Year at least", "in": "query", "name": "year.gte", "required": false, "schema": { "type": "integer" } }, { "description": "Year at most", "in": "query", "name": "year.lte", "required": false, "schema": { "type": "integer" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 500, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "series": { "type": "string" }, "twh": { "type": "number" }, "year": { "format": "int32", "type": "integer" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Electricity production and use per year", "x-bucket": "electricity_balance", "x-tier": "light" } }, "/v1/energy/electricity/by-source": { "get": { "operationId": "electricity-forecast", "parameters": [ { "description": "Year equals", "in": "query", "name": "year", "required": false, "schema": { "type": "integer" } }, { "description": "Year at least", "in": "query", "name": "year.gte", "required": false, "schema": { "type": "integer" } }, { "description": "Year at most", "in": "query", "name": "year.lte", "required": false, "schema": { "type": "integer" } }, { "description": "Power source equals", "in": "query", "name": "series", "required": false, "schema": { "type": "string" } }, { "description": "Power source one of (comma-separated)", "in": "query", "name": "series.in", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 500, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "series": { "description": "Power source", "type": "string" }, "twh": { "type": "number" }, "year": { "format": "int32", "type": "integer" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Electricity production per source with forecast", "x-bucket": "electricity_forecast", "x-tier": "light" } }, "/v1/foods": { "get": { "operationId": "foods", "parameters": [ { "description": "Name or its beginning, lower case equals", "in": "query", "name": "name", "required": false, "schema": { "type": "string" } }, { "description": "Name or its beginning, lower case starts with", "in": "query", "name": "name.prefix", "required": false, "schema": { "type": "string" } }, { "description": "Food number equals", "in": "query", "name": "food_id", "required": false, "schema": { "type": "integer" } }, { "description": "Food number one of (comma-separated)", "in": "query", "name": "food_id.in", "required": false, "schema": { "type": "string" } }, { "description": "Protein per 100 g at least", "in": "query", "name": "protein_g.gte", "required": false, "schema": { "type": "number" } }, { "description": "Protein per 100 g at most", "in": "query", "name": "protein_g.lte", "required": false, "schema": { "type": "number" } }, { "description": "Fibre per 100 g at least", "in": "query", "name": "fibre_g.gte", "required": false, "schema": { "type": "number" } }, { "description": "Fibre per 100 g at most", "in": "query", "name": "fibre_g.lte", "required": false, "schema": { "type": "number" } }, { "description": "kcal per 100 g at least", "in": "query", "name": "energy_kcal.gte", "required": false, "schema": { "type": "number" } }, { "description": "kcal per 100 g at most", "in": "query", "name": "energy_kcal.lte", "required": false, "schema": { "type": "number" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "calcium_mg": { "type": "number" }, "carbohydrates_g": { "type": "number" }, "energy_kcal": { "type": "number" }, "fat_g": { "type": "number" }, "fibre_g": { "type": "number" }, "food_id": { "format": "int32", "type": "integer" }, "iron_mg": { "type": "number" }, "kind": { "type": "string" }, "name": { "type": "string" }, "protein_g": { "type": "number" }, "salt_g": { "type": "number" }, "saturated_fat_g": { "type": "number" }, "sugars_g": { "type": "number" }, "vitamin_c_mg": { "type": "number" }, "vitamin_d_ug": { "type": "number" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Foods and nutrients per 100 g", "x-attribution": "Source: Livsmedelsverket's food composition database, CC BY 4.0", "x-bucket": "foods", "x-licenses": [ "CC-BY-4.0" ], "x-tier": "light" } }, "/v1/jobs/ads": { "get": { "operationId": "job-ads", "parameters": [ { "description": "total, remote, occupation-field, region or municipality equals", "in": "query", "name": "dimension", "required": true, "schema": { "type": "string" } }, { "description": "Day equals", "in": "query", "name": "date", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Day at least", "in": "query", "name": "date.gte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Day at most", "in": "query", "name": "date.lte", "required": false, "schema": { "format": "date", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 500, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "ads": { "format": "int64", "type": "integer" }, "code": { "description": "County or municipality code", "type": "string" }, "concept_id": { "description": "JobTech taxonomy id", "type": "string" }, "date": { "format": "date", "type": "string" }, "dimension": { "description": "total, remote, occupation-field, region or municipality", "type": "string" }, "term": { "type": "string" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Open job ads per day", "x-bucket": "job_ads", "x-tier": "light" } }, "/v1/jobs/ads/national": { "get": { "operationId": "job-ads-national", "parameters": [ { "description": "Day equals", "in": "query", "name": "date", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Day at least", "in": "query", "name": "date.gte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Day at most", "in": "query", "name": "date.lte", "required": false, "schema": { "format": "date", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 500, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "ads": { "format": "int64", "type": "integer" }, "date": { "format": "date", "type": "string" }, "remote": { "format": "int64", "type": "integer" }, "remote_share": { "type": "number" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Open job ads in Sweden per day", "x-bucket": "job_ads_national", "x-tier": "light" } }, "/v1/medicines/shortages": { "get": { "operationId": "medicine-shortages", "parameters": [ { "description": "Still ongoing equals", "in": "query", "name": "ongoing", "required": false, "schema": { "type": "boolean" } }, { "description": "ATC code or its beginning equals", "in": "query", "name": "atc_code", "required": false, "schema": { "type": "string" } }, { "description": "ATC code or its beginning starts with", "in": "query", "name": "atc_code.prefix", "required": false, "schema": { "type": "string" } }, { "description": "First day equals", "in": "query", "name": "starts", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "First day at least", "in": "query", "name": "starts.gte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "First day at most", "in": "query", "name": "starts.lte", "required": false, "schema": { "format": "date", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "atc_code": { "type": "string" }, "atc_group": { "description": "ATC main group (A alimentary tract, N nervous system, ...)", "type": "string" }, "ended": { "format": "date", "type": "string" }, "ends_forecast": { "format": "date", "type": "string" }, "holder": { "description": "Marketing authorisation holder", "type": "string" }, "last_updated": { "format": "date", "type": "string" }, "npl_pack_id": { "type": "string" }, "ongoing": { "type": "boolean" }, "package": { "type": "string" }, "product": { "type": "string" }, "shortage_id": { "type": "string" }, "starts": { "format": "date", "type": "string" }, "substances": { "type": "string" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Medicine shortages", "x-attribution": "Contains data from Läkemedelsverket, CC BY 4.0", "x-bucket": "medicine_shortages", "x-licenses": [ "CC-BY-4.0" ], "x-tier": "light" } }, "/v1/medicines/shortages/by-group": { "get": { "operationId": "medicine-shortages-by-group", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "maximum": 50, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "atc_group": { "type": "string" }, "packages": { "format": "int64", "type": "integer" }, "products": { "format": "int64", "type": "integer" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Ongoing shortages per ATC group", "x-attribution": "Contains data from Läkemedelsverket, CC BY 4.0", "x-bucket": "medicine_shortages_by_group", "x-licenses": [ "CC-BY-4.0" ], "x-tier": "light" } }, "/v1/medicines/shortages/monthly": { "get": { "operationId": "medicine-shortages-monthly", "parameters": [ { "description": "Month equals", "in": "query", "name": "month", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Month at least", "in": "query", "name": "month.gte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Month at most", "in": "query", "name": "month.lte", "required": false, "schema": { "format": "date", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 500, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "month": { "format": "date", "type": "string" }, "packages": { "description": "Packages affected", "format": "int64", "type": "integer" }, "shortages": { "description": "Shortages that started", "format": "int64", "type": "integer" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "New medicine shortages per month", "x-attribution": "Contains data from Läkemedelsverket, CC BY 4.0", "x-bucket": "medicine_shortages_monthly", "x-licenses": [ "CC-BY-4.0" ], "x-tier": "light" } }, "/v1/municipalities/figures": { "get": { "operationId": "municipal-figures", "parameters": [ { "description": "Kolada key figure id, e.g. N00900 equals", "in": "query", "name": "kpi", "required": true, "schema": { "type": "string" } }, { "description": "Kolada key figure id, e.g. N00900 one of (comma-separated)", "in": "query", "name": "kpi.in", "required": false, "schema": { "type": "string" } }, { "description": "Municipality or region id equals", "in": "query", "name": "municipality_id", "required": false, "schema": { "type": "string" } }, { "description": "Municipality or region id one of (comma-separated)", "in": "query", "name": "municipality_id.in", "required": false, "schema": { "type": "string" } }, { "description": "Year equals", "in": "query", "name": "year", "required": false, "schema": { "type": "integer" } }, { "description": "Year at least", "in": "query", "name": "year.gte", "required": false, "schema": { "type": "integer" } }, { "description": "Year at most", "in": "query", "name": "year.lte", "required": false, "schema": { "type": "integer" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 1000, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "kpi": { "description": "Kolada key figure id", "type": "string" }, "kpi_title": { "type": "string" }, "municipality": { "type": "string" }, "municipality_id": { "type": "string" }, "municipality_type": { "description": "K municipality, L region", "type": "string" }, "value": { "type": "number" }, "year": { "format": "int32", "type": "integer" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Key figures per municipality and year (Kolada)", "x-attribution": "Source: Kolada (RKA), CC BY 4.0", "x-bucket": "municipal_figures", "x-licenses": [ "CC-BY-4.0" ], "x-tier": "light" } }, "/v1/municipalities/figures/latest": { "get": { "operationId": "municipal-figures-latest", "parameters": [ { "description": "Kolada key figure id equals", "in": "query", "name": "kpi", "required": true, "schema": { "type": "string" } }, { "description": "Kolada key figure id one of (comma-separated)", "in": "query", "name": "kpi.in", "required": false, "schema": { "type": "string" } }, { "description": "K municipality, L region equals", "in": "query", "name": "municipality_type", "required": false, "schema": { "type": "string" } }, { "description": "Id equals", "in": "query", "name": "municipality_id", "required": false, "schema": { "type": "string" } }, { "description": "Id one of (comma-separated)", "in": "query", "name": "municipality_id.in", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 400, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "kpi": { "type": "string" }, "kpi_title": { "type": "string" }, "municipality": { "type": "string" }, "municipality_id": { "type": "string" }, "municipality_type": { "type": "string" }, "value": { "type": "number" }, "year": { "format": "int32", "type": "integer" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Key figures per municipality, latest year", "x-attribution": "Source: Kolada (RKA), CC BY 4.0", "x-bucket": "municipal_figures_latest", "x-licenses": [ "CC-BY-4.0" ], "x-tier": "light" } }, "/v1/rates/riksbank": { "get": { "operationId": "riksbank-rates", "parameters": [ { "description": "SECBREPOEFF policy rate, SEKEURPMI, SEKUSDPMI, SEKGBPPMI equals", "in": "query", "name": "series", "required": true, "schema": { "type": "string" } }, { "description": "SECBREPOEFF policy rate, SEKEURPMI, SEKUSDPMI, SEKGBPPMI one of (comma-separated)", "in": "query", "name": "series.in", "required": false, "schema": { "type": "string" } }, { "description": "Day equals", "in": "query", "name": "date", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Day at least", "in": "query", "name": "date.gte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Day at most", "in": "query", "name": "date.lte", "required": false, "schema": { "format": "date", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 1000, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "date": { "format": "date", "type": "string" }, "description": { "type": "string" }, "series": { "description": "SECBREPOEFF policy rate, SEKEURPMI, SEKUSDPMI, SEKGBPPMI", "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Policy rate and exchange rates per day", "x-attribution": "Source: Sveriges riksbank, CC BY 4.0", "x-bucket": "riksbank_rates", "x-licenses": [ "CC-BY-4.0" ], "x-tier": "light" } }, "/v1/rates/swestr": { "get": { "operationId": "swestr", "parameters": [ { "description": "Day equals", "in": "query", "name": "date", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Day at least", "in": "query", "name": "date.gte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Day at most", "in": "query", "name": "date.lte", "required": false, "schema": { "format": "date", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 1000, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "date": { "format": "date", "type": "string" }, "pctl12_5": { "description": "12.5th percentile of the transactions' rates", "type": "number" }, "pctl87_5": { "description": "87.5th percentile", "type": "number" }, "rate": { "description": "Percent", "type": "number" }, "transactions": { "format": "int32", "type": "integer" }, "volume_msek": { "description": "Transaction volume, SEK million", "type": "number" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Swestr per day", "x-attribution": "Source: Sveriges riksbank, CC BY 4.0", "x-bucket": "swestr", "x-licenses": [ "CC-BY-4.0" ], "x-tier": "light" } }, "/v1/riksdag/party-agreement": { "get": { "operationId": "party-agreement", "parameters": [ { "description": "Party, e.g. S equals", "in": "query", "name": "party", "required": false, "schema": { "type": "string" } }, { "description": "Party, e.g. S one of (comma-separated)", "in": "query", "name": "party.in", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 200, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "other_party": { "type": "string" }, "party": { "type": "string" }, "same": { "format": "int64", "type": "integer" }, "share": { "type": "number" }, "votes": { "description": "Votes where both parties voted yes or no", "format": "int64", "type": "integer" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "How often the parties vote alike", "x-attribution": "Source: Sveriges riksdag", "x-bucket": "party_agreement", "x-licenses": [ "Riksdagen open data terms (free use with attribution)" ], "x-tier": "light" } }, "/v1/riksdag/party-attendance": { "get": { "operationId": "party-attendance", "parameters": [ { "description": "Session, e.g. 2025/26 equals", "in": "query", "name": "riksmote", "required": false, "schema": { "type": "string" } }, { "description": "Session, e.g. 2025/26 one of (comma-separated)", "in": "query", "name": "riksmote.in", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 200, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "absent_share": { "type": "number" }, "abstain_share": { "type": "number" }, "party": { "description": "- is members without a party", "type": "string" }, "riksmote": { "description": "Session, e.g. 2025/26", "type": "string" }, "votes": { "format": "int64", "type": "integer" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Votes and absence per party", "x-attribution": "Source: Sveriges riksdag", "x-bucket": "party_attendance", "x-licenses": [ "Riksdagen open data terms (free use with attribution)" ], "x-tier": "light" } }, "/v1/stats/dnssec": { "get": { "operationId": "stats-dnssec", "parameters": [ { "description": "Zone: se or nu equals", "in": "query", "name": "tld", "required": false, "schema": { "type": "string" } }, { "description": "Zone: se or nu one of (comma-separated)", "in": "query", "name": "tld.in", "required": false, "schema": { "type": "string" } }, { "description": "Day equals", "in": "query", "name": "date", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Day at least", "in": "query", "name": "date.gte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Day at most", "in": "query", "name": "date.lte", "required": false, "schema": { "format": "date", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "date": { "description": "Day of the snapshot (Europe/Stockholm)", "format": "date", "type": "string" }, "domains": { "format": "int64", "type": "integer" }, "ecdsa_p256": { "description": "Signed with algorithm 13 (ECDSA P-256)", "format": "int64", "type": "integer" }, "rsa_sha256": { "description": "Signed with algorithm 8 (RSA/SHA-256)", "format": "int64", "type": "integer" }, "share_signed": { "type": "number" }, "signed": { "description": "Domains with a DS record", "format": "int64", "type": "integer" }, "tld": { "type": "string" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "DNSSEC adoption per zone and day", "x-attribution": "Contains data from the Swedish Internet Foundation (Internetstiftelsen), licensed under CC BY 4.0", "x-bucket": "dnssec_adoption_over_time", "x-licenses": [ "CC-BY-4.0" ], "x-tier": "light" } }, "/v1/stats/nameservers": { "get": { "operationId": "stats-nameservers", "parameters": [ { "description": "Zone: se or nu equals", "in": "query", "name": "tld", "required": false, "schema": { "type": "string" } }, { "description": "Zone: se or nu one of (comma-separated)", "in": "query", "name": "tld.in", "required": false, "schema": { "type": "string" } }, { "description": "Operator (registered domain of the NS hosts) equals", "in": "query", "name": "operator", "required": false, "schema": { "type": "string" } }, { "description": "Operator (registered domain of the NS hosts) starts with", "in": "query", "name": "operator.prefix", "required": false, "schema": { "type": "string" } }, { "description": "Minimum number of domains at least", "in": "query", "name": "domains.gte", "required": false, "schema": { "type": "integer" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "domains": { "description": "Domains with at least one name server at this operator", "format": "int64", "type": "integer" }, "fetched_at": { "format": "date-time", "type": "string" }, "operator": { "description": "Registered domain of the name server hosts, e.g. loopia.se", "type": "string" }, "serial": { "format": "int64", "type": "integer" }, "share": { "description": "domains / all domains in the zone", "type": "number" }, "tld": { "type": "string" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Name server operators and market share", "x-attribution": "Contains data from the Swedish Internet Foundation (Internetstiftelsen), licensed under CC BY 4.0", "x-bucket": "nameserver_market_share", "x-licenses": [ "CC-BY-4.0" ], "x-tier": "standard" } }, "/v1/sweden/cpi": { "get": { "operationId": "consumer-prices", "parameters": [ { "description": "00000807 index, 00000804 12-month change, 00000806 monthly change equals", "in": "query", "name": "measure_code", "required": false, "schema": { "type": "string" } }, { "description": "00000807 index, 00000804 12-month change, 00000806 monthly change one of (comma-separated)", "in": "query", "name": "measure_code.in", "required": false, "schema": { "type": "string" } }, { "description": "Month (first day) equals", "in": "query", "name": "month", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Month (first day) at least", "in": "query", "name": "month.gte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Month (first day) at most", "in": "query", "name": "month.lte", "required": false, "schema": { "format": "date", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 1000, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "measure": { "type": "string" }, "measure_code": { "description": "00000807 index, 00000804 12-month change, 00000806 monthly change", "type": "string" }, "month": { "description": "First day of the month", "format": "date", "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Consumer price index per month", "x-bucket": "consumer_prices", "x-tier": "light" } }, "/v1/sweden/house-prices": { "get": { "operationId": "house-prices", "parameters": [ { "description": "00 Sweden, 0010 Greater Stockholm, ... equals", "in": "query", "name": "region_code", "required": false, "schema": { "type": "string" } }, { "description": "00 Sweden, 0010 Greater Stockholm, ... one of (comma-separated)", "in": "query", "name": "region_code.in", "required": false, "schema": { "type": "string" } }, { "description": "Year equals", "in": "query", "name": "year", "required": false, "schema": { "type": "integer" } }, { "description": "Year at least", "in": "query", "name": "year.gte", "required": false, "schema": { "type": "integer" } }, { "description": "Year at most", "in": "query", "name": "year.lte", "required": false, "schema": { "type": "integer" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 1000, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "index": { "description": "1981 = 100", "type": "number" }, "region": { "type": "string" }, "region_code": { "type": "string" }, "year": { "format": "int32", "type": "integer" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "House price index", "x-bucket": "house_price_index", "x-tier": "light" } }, "/v1/sweden/population": { "get": { "operationId": "population", "parameters": [ { "description": "00 Sweden, 2 digits county, 4 digits municipality equals", "in": "query", "name": "region_code", "required": false, "schema": { "type": "string" } }, { "description": "00 Sweden, 2 digits county, 4 digits municipality one of (comma-separated)", "in": "query", "name": "region_code.in", "required": false, "schema": { "type": "string" } }, { "description": "country, county or municipality equals", "in": "query", "name": "level", "required": false, "schema": { "type": "string" } }, { "description": "Year equals", "in": "query", "name": "year", "required": false, "schema": { "type": "integer" } }, { "description": "Year at least", "in": "query", "name": "year.gte", "required": false, "schema": { "type": "integer" } }, { "description": "Year at most", "in": "query", "name": "year.lte", "required": false, "schema": { "type": "integer" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 1000, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "level": { "type": "string" }, "population": { "format": "int64", "type": "integer" }, "region": { "type": "string" }, "region_code": { "description": "00 Sweden, 2 digits county, 4 digits municipality", "type": "string" }, "year": { "format": "int32", "type": "integer" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Population per region and year", "x-bucket": "population_by_region", "x-tier": "light" } }, "/v1/sweden/population/latest": { "get": { "operationId": "population-latest", "parameters": [ { "description": "Region code equals", "in": "query", "name": "region_code", "required": false, "schema": { "type": "string" } }, { "description": "Region code one of (comma-separated)", "in": "query", "name": "region_code.in", "required": false, "schema": { "type": "string" } }, { "description": "country, county or municipality equals", "in": "query", "name": "level", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 400, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "change_pct": { "description": "Change since first_year, percent", "type": "number" }, "first_year": { "format": "int32", "type": "integer" }, "level": { "type": "string" }, "population": { "description": "Population in the latest year", "format": "int64", "type": "integer" }, "region": { "type": "string" }, "region_code": { "type": "string" }, "year": { "description": "Latest year", "format": "int32", "type": "integer" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Population in the latest year and change", "x-bucket": "population_latest", "x-tier": "light" } }, "/v1/tourism/guest-nights": { "get": { "operationId": "guest-nights", "parameters": [ { "description": "Month equals", "in": "query", "name": "month", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Month at least", "in": "query", "name": "month.gte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Month at most", "in": "query", "name": "month.lte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Sverige or Utland equals", "in": "query", "name": "origin", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 1000, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "month": { "format": "date", "type": "string" }, "nights": { "format": "int64", "type": "integer" }, "origin": { "description": "Sverige or Utland", "type": "string" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Guest nights per month", "x-bucket": "guest_nights_monthly", "x-tier": "light" } }, "/v1/tourism/guest-nights/by-country": { "get": { "operationId": "guest-nights-by-country", "parameters": [ { "description": "Year equals", "in": "query", "name": "year", "required": true, "schema": { "type": "integer" } }, { "description": "Year at least", "in": "query", "name": "year.gte", "required": false, "schema": { "type": "integer" } }, { "description": "Year at most", "in": "query", "name": "year.lte", "required": false, "schema": { "type": "integer" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 500, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "country": { "type": "string" }, "nights": { "format": "int64", "type": "integer" }, "year": { "format": "int32", "type": "integer" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Foreign guest nights per country and year", "x-bucket": "guest_nights_by_country", "x-tier": "light" } }, "/v1/tourism/guest-nights/by-county": { "get": { "operationId": "guest-nights-by-county", "parameters": [ { "description": "Year equals", "in": "query", "name": "year", "required": false, "schema": { "type": "integer" } }, { "description": "Year at least", "in": "query", "name": "year.gte", "required": false, "schema": { "type": "integer" } }, { "description": "Year at most", "in": "query", "name": "year.lte", "required": false, "schema": { "type": "integer" } }, { "description": "County code equals", "in": "query", "name": "county_code", "required": false, "schema": { "type": "string" } }, { "description": "County code one of (comma-separated)", "in": "query", "name": "county_code.in", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "county": { "type": "string" }, "county_code": { "type": "string" }, "foreign_share": { "type": "number" }, "nights": { "format": "int64", "type": "integer" }, "year": { "format": "int32", "type": "integer" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Guest nights per county and year", "x-bucket": "guest_nights_by_county", "x-tier": "light" } }, "/v1/trains/punctuality": { "get": { "operationId": "train-punctuality", "parameters": [ { "description": "Day equals", "in": "query", "name": "date", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Day at least", "in": "query", "name": "date.gte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Day at most", "in": "query", "name": "date.lte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Location signature, e.g. Cst equals", "in": "query", "name": "station", "required": false, "schema": { "type": "string" } }, { "description": "Location signature, e.g. Cst one of (comma-separated)", "in": "query", "name": "station.in", "required": false, "schema": { "type": "string" } }, { "description": "Minimum arrivals at least", "in": "query", "name": "arrivals.gte", "required": false, "schema": { "type": "integer" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "arrivals": { "format": "int64", "type": "integer" }, "avg_delay_min": { "description": "Average delay, early counted as 0", "type": "number" }, "canceled": { "format": "int64", "type": "integer" }, "date": { "format": "date", "type": "string" }, "on_time": { "description": "At most 5 minutes late", "format": "int64", "type": "integer" }, "on_time_share": { "description": "Share on time among cancelled and reported arrivals", "type": "number" }, "station": { "description": "Location signature", "type": "string" }, "station_name": { "type": "string" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Train punctuality per station and day", "x-bucket": "train_punctuality", "x-tier": "light" } }, "/v1/trains/punctuality/daily": { "get": { "operationId": "train-punctuality-daily", "parameters": [ { "description": "Day equals", "in": "query", "name": "date", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Day at least", "in": "query", "name": "date.gte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Day at most", "in": "query", "name": "date.lte", "required": false, "schema": { "format": "date", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 400, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "arrivals": { "format": "int64", "type": "integer" }, "avg_delay_min": { "type": "number" }, "canceled": { "format": "int64", "type": "integer" }, "date": { "format": "date", "type": "string" }, "on_time_share": { "type": "number" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Train punctuality in Sweden per day", "x-bucket": "train_punctuality_daily", "x-tier": "light" } }, "/v1/weather/history": { "get": { "operationId": "weather-history", "parameters": [ { "description": "SMHI station id equals", "in": "query", "name": "station_id", "required": true, "schema": { "type": "string" } }, { "description": "SMHI station id one of (comma-separated)", "in": "query", "name": "station_id.in", "required": false, "schema": { "type": "string" } }, { "description": "Parameter equals", "in": "query", "name": "parameter", "required": false, "schema": { "type": "string" } }, { "description": "Parameter one of (comma-separated)", "in": "query", "name": "parameter.in", "required": false, "schema": { "type": "string" } }, { "description": "Day equals", "in": "query", "name": "date", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Day at least", "in": "query", "name": "date.gte", "required": false, "schema": { "format": "date", "type": "string" } }, { "description": "Day at most", "in": "query", "name": "date.lte", "required": false, "schema": { "format": "date", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 500, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "date": { "description": "Day (Europe/Stockholm)", "format": "date", "type": "string" }, "observed_at": { "format": "date-time", "type": "string" }, "parameter": { "description": "1 temperature, 4 wind speed, 6 humidity, 7 precipitation", "type": "string" }, "quality": { "description": "G checked, Y suspect (latest-hour data is not quality-controlled)", "type": "string" }, "station": { "type": "string" }, "station_id": { "description": "SMHI station id", "type": "string" }, "unit": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Weather per hour and station", "x-attribution": "Contains data from SMHI (Swedish Meteorological and Hydrological Institute), CC BY 4.0", "x-bucket": "weather_hourly", "x-licenses": [ "CC-BY-4.0" ], "x-tier": "standard" } }, "/v1/weather/now": { "get": { "operationId": "weather-now", "parameters": [ { "description": "1 temperature, 4 wind, 6 humidity, 7 precipitation equals", "in": "query", "name": "parameter", "required": false, "schema": { "type": "string" } }, { "description": "1 temperature, 4 wind, 6 humidity, 7 precipitation one of (comma-separated)", "in": "query", "name": "parameter.in", "required": false, "schema": { "type": "string" } }, { "description": "SMHI station id equals", "in": "query", "name": "station_id", "required": false, "schema": { "type": "string" } }, { "description": "SMHI station id one of (comma-separated)", "in": "query", "name": "station_id.in", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 500, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "next_cursor from the previous page", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "_meta": { "$ref": "#/components/schemas/Meta" }, "data": { "items": { "properties": { "latitude": { "type": "number" }, "longitude": { "type": "number" }, "observed_at": { "format": "date-time", "type": "string" }, "parameter": { "description": "1 temperature, 4 wind speed, 6 humidity, 7 precipitation", "type": "string" }, "parameter_name": { "type": "string" }, "quality": { "description": "G checked, Y suspect (latest-hour data is not quality-controlled)", "type": "string" }, "station": { "type": "string" }, "station_id": { "description": "SMHI station id", "type": "string" }, "unit": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "next_cursor": { "description": "Present when there are more rows", "type": "string" } }, "required": [ "data", "_meta" ], "type": "object" } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid parameters" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing or invalid API key" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limit reached" } }, "security": [ {}, { "bearer": [] }, { "apiKey": [] } ], "summary": "Current weather per SMHI station", "x-attribution": "Contains data from SMHI (Swedish Meteorological and Hydrological Institute), CC BY 4.0", "x-bucket": "weather_now", "x-licenses": [ "CC-BY-4.0" ], "x-tier": "light" } } }, "servers": [ { "url": "https://api.aleva.se" } ] }