{ "openapi": "3.1.0", "info": { "title": "Atvērtie dati public API", "version": "1.0.0", "description": "Latvian open data as a metered JSON API — companies, real estate, rates, prices and statistical indices.\n\nAuthenticate with an API key in the `X-Api-Key` header. Keys are created in the developer portal. Keys sent in the query string are rejected.", "contact": { "url": "https://api.atvertiedati.lv" }, "license": { "name": "CC BY 4.0", "identifier": "CC-BY-4.0" } }, "servers": [ { "url": "https://api.atvertiedati.lv" } ], "security": [ { "ApiKeyAuth": [] } ], "tags": [ { "name": "companies", "description": "Latvian company registry — profiles, officers, beneficial owners, shareholders, activities and annual financial statements." }, { "name": "nace", "description": "NACE Rev. 2 economic activity classifier, searchable and as a full hierarchy." }, { "name": "real-estate", "description": "Property transactions, addresses, buildings, land parcels and per-city price statistics." }, { "name": "rates", "description": "Euribor reference rates and Latvian consumer loan rates." }, { "name": "prices", "description": "Retail fuel prices and household electricity plans including Nord Pool spot history." }, { "name": "indices", "description": "CSP consumer price indices and pension capital data." }, { "name": "election-candidates", "description": "CVK Saeima election candidates, their lists and aggregate statistics." } ], "paths": { "/v1/cities": { "get": { "operationId": "api_v1_cities_list", "summary": "Search cities and regions", "description": "The place names that appear in registered company addresses, with a\ncount of companies registered in each.\n\nIntended for building the `city` filter on `/v1/companies`: every `name`\nreturned here is a valid value for that filter.\n\nA name is the leading segment of the registered address as the company\nregister writes it, so regional municipalities appear in their\nabbreviated form (`Limbažu nov.`, not `Limbažu novads`) — passing either\nto `/v1/companies?city=` works, because that filter normalises the\ncommon suffixes. `company_count` counts the companies whose address\n*begins* with the name; the `city` filter matches the name anywhere in\nthe address, so it can return somewhat more.\n\nPlaces with fewer than 5 registered companies are omitted — the tail is\nalmost entirely address strings that carry no comma.\n\n**Quota cost:** 1 unit per call.", "tags": [ "nace" ], "parameters": [ { "name": "q", "in": "query", "required": false, "description": "Name prefix; at least 2 characters", "schema": { "type": "string" }, "example": "Rīg" }, { "name": "per_page", "in": "query", "required": false, "description": "Results per page", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "example": 50 } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": [ { "name": "Rīga", "company_count": 227764 }, { "name": "Rīgas rajons", "company_count": 4063 } ], "meta": { "page": 1, "per_page": 50, "count": 2, "generated_at": "2026-09-14T19:22:47+02:00" }, "links": { "self": "https://api.atvertiedati.lv/v1/cities?q=R%C4%ABg&per_page=50&page=1", "next": null, "prev": null } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/companies": { "get": { "operationId": "api_v1_companies_list", "summary": "Search companies", "description": "Search the Latvian company registry. Combine any of the filters below;\nthey are ANDed together.\n\nTwo of them deserve a note:\n\n- **`nace`** takes classifier codes, and each code includes its\n descendants — asking for `56` returns the restaurants and caterers\n beneath it, not only companies whose registered activity repeats the\n division's own wording.\n- **`city`** is matched against the registered address as written, with\n Latvian regional suffixes normalised, so `Limbažu novads` finds\n addresses recorded as `Limbažu nov.`\n\nEmployee and turnover filters read the most recently filed annual\nstatement. Companies that have never filed one are excluded when either\nfilter is used.\n\n**Quota cost:** 1 unit per call.", "tags": [ "companies" ], "parameters": [ { "name": "q", "in": "query", "required": false, "description": "Company name prefix", "schema": { "type": "string" }, "example": "Latvijas" }, { "name": "city", "in": "query", "required": false, "description": "City or region of the registered address", "schema": { "type": "string" }, "example": "Rīga" }, { "name": "nace", "in": "query", "required": false, "description": "Comma-separated NACE codes; includes sub-categories", "schema": { "type": "string" }, "example": "56.10" }, { "name": "activity", "in": "query", "required": false, "description": "Free-text match on the registered activity description", "schema": { "type": "string" }, "example": null }, { "name": "status", "in": "query", "required": false, "description": "Registry status", "schema": { "type": "string", "enum": [ "active", "liquidated" ] }, "example": "active" }, { "name": "employees_min", "in": "query", "required": false, "description": "Minimum employees in the latest statement", "schema": { "type": "integer", "minimum": 0 }, "example": 10 }, { "name": "employees_max", "in": "query", "required": false, "description": "Maximum employees in the latest statement", "schema": { "type": "integer", "minimum": 0 }, "example": null }, { "name": "turnover_min", "in": "query", "required": false, "description": "Minimum net turnover, EUR", "schema": { "type": "integer", "minimum": 0 }, "example": null }, { "name": "turnover_max", "in": "query", "required": false, "description": "Maximum net turnover, EUR", "schema": { "type": "integer", "minimum": 0 }, "example": null }, { "name": "page", "in": "query", "required": false, "description": "Page number", "schema": { "type": "integer", "minimum": 1, "default": 1 }, "example": 1 }, { "name": "per_page", "in": "query", "required": false, "description": "Results per page", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "example": 50 } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": [ { "reg_code": "40003250113", "name": "Latvijas - Vācijas kopuzņēmums SIA \"HM RĪGA\"", "address": "Rīga, Mūkusalas iela 63", "post_code": "1004", "registered": "1995-03-23", "liquidated": null, "status": "active", "legal_form": "Sabiedrība ar ierobežotu atbildību", "entity_type": "Komercreģistrs", "area_of_activity": "reprocentra darbi\r\nizdevējdarbība \r\npoligrāfija \r\nredakciju darbi\r\nreklāma \r\nmaksas pakalpojumi \r\nvisu veidu tirdzniecība \r\nārējā ekonomiskā darbība \r\npreču ražošana un realizācija \r\nkursu organizēšana\r\nstarpniecība \r\nremonta-celtniecības darbi \r\ntransporta pakalpojumi \r\nu.c. statūtos paredzētā darbība", "latest_financials": { "year": 2018, "employees": 17, "net_turnover": 1478717 } }, { "reg_code": "40008016156", "name": "Latvijas anatomu, histologu un embriologu biedrība", "address": "Rīga, Kronvalda bulvāris 9", "post_code": "1010", "registered": "1997-10-01", "liquidated": null, "status": "active", "legal_form": "Biedrība", "entity_type": "Biedrību un nodibinājumu reģistrs", "area_of_activity": "Veicināt, koordinēt pētniecisko darbu anatomijā un embrioloģijā;\r\nsniegt konsultācijas Rīgas Stradiņa universitātes un citu Latvijas augstskolu studentiem;\r\norganizēt lekciju kursus nolūkā sniegt studentiem un citiem interesentiem zināšanas anatomijas, histoloģijas un embrioloģijas zinātnes nozarēs;\r\nkonsultēt maģistra darbu un doktora disertāciju sagatavošanu anatomijā, histoloģijā, embrioloģijā un to saskarzinātnēs;\r\nsniegt praktiska rakstiura rekomendācijas medicīnas, izglītības un citu nozaru speciālistiem;\r\niesaistīt Latvijas un citu valstu zinātniekus, kuri darbojas anatomijas, histoloģijas un embrioloģijas nozarēs, jaunu speciālistu sagatavošanā Latvijas anatomu, histologu un embrioloģijas nozarēs, jaunu speciālistu sagatavošanā Latvijas anatomu, histologu un embriologu skolas turpmākai attīstībai;\r\ndarboties Eiropas anatomu, histologu un embriologu Asociācijā, lai iegūtu pilnīgu un regulāru informāciju par zinātniski pētniecisko darbu anatomijas, histoloģijas un embrioloģijas nozarēs dažādās Eiropas valstīs;\r\np[iedalīties Eiropas anatomu, histologu un embriologu Asociācijas rīkotajos pasākumos: kongresos, simpozijos, konferencēs;\r\npatstāvīgi, kā arī sadarbībā ar Rīgas Stradiņa universitātes Anatomijas un antropoloģijas institūta Anatomijas studiju nodaļu, histoloģijas studiju nodaļu, embrioloģijas studiju nodaļu, J.Prīmaņa Anatomijas muzeju u.c. institūcijām piedalīties zinātnisku konferenču organizēšanā;\r\npopularizēt anatomijas, histoloģijas un embrioloģijas zinātnes sasnegumus;\r\ndot atzinumus anatomijas histoloģijas un embrioloģijas jomā.", "latest_financials": { "year": 2018, "employees": 20, "net_turnover": null } }, { "reg_code": "40008007327", "name": "Latvijas Antropologu zinātniskā biedrība", "address": "Rīga, Kronvalda bulvāris 9", "post_code": "1010", "registered": "1994-05-12", "liquidated": null, "status": "active", "legal_form": "Biedrība", "entity_type": "Biedrību un nodibinājumu reģistrs", "area_of_activity": "Veicināt un koordinēt antropoloģiskos pētījumus Latvijas augstskolās un citās zinātniskajās institūcijās;\r\nsniegt sabiedrībai zināšanas par antropoloģiju, t.sk. organizēt lekciju kursus Latvijas izglītības iestādēs, sekmēt maģistra un promocijas darbu sagatavošanu antropoloģijā un tās sakardisciplīnās;\r\norganizēt zinātniskās konferences, piedalīties Eiropas Antropoloģiskās asociācijas kongresos, konferencēs un simpozijos.", "latest_financials": { "year": 2018, "employees": 15, "net_turnover": null } } ], "meta": { "page": 1, "per_page": 50, "count": 46, "total": 46, "total_pages": 1, "generated_at": "2026-09-14T19:22:47+02:00" }, "links": { "self": "https://api.atvertiedati.lv/v1/companies?q=Latvijas&city=R%C4%ABga&nace=56.10&status=active&employees_min=10&page=1&per_page=50", "next": null, "prev": null } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/companies/{regCode}": { "get": { "operationId": "api_v1_companies_get", "summary": "Get one company", "description": "Full registry profile for a single company, including its latest filed annual figures.\n\n**Quota cost:** 1 unit per call.", "tags": [ "companies" ], "parameters": [ { "name": "regCode", "in": "path", "required": true, "description": "Registration number", "schema": { "type": "string" }, "example": "40003457109" } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "reg_code": "40003457109", "name": "Valsts sabiedrība ar ierobežotu atbildību \"Paula Stradiņa klīniskā universitātes slimnīca\"", "address": "Rīga, Pilsoņu iela 13", "post_code": "1002", "registered": "1999-08-24", "liquidated": null, "status": "active", "legal_form": "Sabiedrība ar ierobežotu atbildību", "entity_type": "Komercreģistrs", "area_of_activity": null, "address_code": "102696742", "closed": " ", "latest_financials": { "year": 2018, "employees": 2923, "net_turnover": 104982580 } }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/companies/{regCode}/activities": { "get": { "operationId": "api_v1_companies_activities", "summary": "Get registered activities", "description": "The company's registered area of activity and legal form, as recorded by the registry.\n\n**Quota cost:** 1 unit per call.", "tags": [ "companies" ], "parameters": [ { "name": "regCode", "in": "path", "required": true, "description": "Registration number", "schema": { "type": "string" }, "example": "40003457109" } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "reg_code": "40003457109", "area_of_activity": null, "legal_form_code": null, "legal_form_text": null, "updated_at": null }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/companies/{regCode}/addresses": { "get": { "operationId": "api_v1_companies_addresses", "summary": "List company addresses", "description": "Registered addresses recorded for the company, with their address classifier codes.\n\n**Quota cost:** 1 unit per call.", "tags": [ "companies" ], "parameters": [ { "name": "regCode", "in": "path", "required": true, "description": "Registration number", "schema": { "type": "string" }, "example": "40003457109" } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "reg_code": "40003457109", "addresses": [ { "address": "Rīga, Pilsoņu iela 13", "post_code": "1002", "address_code": "102696742", "atvk": "0010000", "region_code": "0", "city_code": "100003003" } ] }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/companies/{regCode}/beneficial-owners": { "get": { "operationId": "api_v1_companies_beneficial_owners", "summary": "List beneficial owners", "description": "Registered ultimate beneficial owners. Identifiers are masked as published by the registry.\n\n**Quota cost:** 1 unit per call.", "tags": [ "companies" ], "parameters": [ { "name": "regCode", "in": "path", "required": true, "description": "Registration number", "schema": { "type": "string" }, "example": "40003457109" } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "_note": "Synthetic example — beneficial owners are named individuals. An empty array is a normal response: many companies have no registered beneficial owner.", "data": { "reg_code": "40003457109", "beneficial_owners": [ { "first_name": "Jānis", "last_name": "Paraugs", "full_name": "Jānis Paraugs", "id_number_masked": "010180-*****", "date_of_birth": "1980-01-01", "nationality": "LV", "residence": "LV", "registered_on": "2018-03-01" } ] }, "meta": { "generated_at": "2026-09-06T22:30:00+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/companies/{regCode}/financials": { "get": { "operationId": "api_v1_companies_financials", "summary": "Get annual financial statements", "description": "Filed annual statements, newest year first, with the income statement\nand balance sheet figures each year reported.\n\nFigures are **as filed**, which means the scale varies: check\n`rounded_to_nearest` before comparing years or companies.\n\n**Quota cost:** 2 units per call.\n\n**Requires:** the Starter plan or higher.", "tags": [ "companies" ], "parameters": [ { "name": "regCode", "in": "path", "required": true, "description": "Registration number", "schema": { "type": "string" }, "example": "40003457109" } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "reg_code": "40003457109", "statements": [ { "year": 2018, "period_start": "2018-01-01", "period_end": "2018-12-31", "currency": "EUR", "rounded_to_nearest": "ONES", "employees": 2923, "income_statement": { "net_turnover": 104982580, "gross_profit": -335406, "income_before_taxes": -2755526, "net_income": -2755526 }, "balance_sheet": { "total_assets": 136252365, "total_current_assets": 17643658, "cash": 8111586, "equity": 30654411, "total_equities": 136252365, "current_liabilities": 23998433, "non_current_liabilities": 81527247 } }, { "year": 2017, "period_start": "2017-01-01", "period_end": "2017-12-31", "currency": "EUR", "rounded_to_nearest": "ONES", "employees": 2946, "income_statement": { "net_turnover": 89638430, "gross_profit": 709054, "income_before_taxes": 6423, "net_income": 6423 }, "balance_sheet": { "total_assets": 133699498, "total_current_assets": 20525466, "cash": 12340889, "equity": 29150519, "total_equities": 133699498, "current_liabilities": 22984469, "non_current_liabilities": 81533748 } }, { "year": 2011, "period_start": "2011-01-01", "period_end": "2011-12-31", "currency": "LVL", "rounded_to_nearest": "ONES", "employees": 2967, "income_statement": { "net_turnover": 53415134, "gross_profit": -5317444, "income_before_taxes": -9426488, "net_income": -8911063 }, "balance_sheet": { "total_assets": 70667422, "total_current_assets": 32195976, "cash": 4376092, "equity": -1640932, "total_equities": 70667422, "current_liabilities": 16720722, "non_current_liabilities": 53901165 } } ] }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/companies/{regCode}/officers": { "get": { "operationId": "api_v1_companies_officers", "summary": "List company officers", "description": "Board members, procurists and other registered officers.\n\nPersonal identifiers are returned exactly as the registry publishes\nthem — partially masked. We do not hold, and cannot return, the full\nidentifier.\n\n**Quota cost:** 1 unit per call.", "tags": [ "companies" ], "parameters": [ { "name": "regCode", "in": "path", "required": true, "description": "Registration number", "schema": { "type": "string" }, "example": "40003457109" } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "_note": "Synthetic example. Officer records name real people, so the documented example uses invented values rather than copying live registry entries into a public page.", "data": { "reg_code": "40003457109", "officers": [ { "full_name": "Paraugs Jānis", "position": "CHAIR_OF_BOARD", "governing_body": "EXECUTIVE_BOARD", "entity_type": "NATURAL_PERSON", "id_number_masked": "010180-*****", "birth_date": "1980-01-01", "represents_company": "", "representation_type": "WITH_ALL", "representation_with_at_least": "0", "registered_on": "2024-11-20" }, { "full_name": "Paraudze Anna", "position": "BOARD_MEMBER", "governing_body": "EXECUTIVE_BOARD", "entity_type": "NATURAL_PERSON", "id_number_masked": "020285-*****", "birth_date": "1985-02-02", "represents_company": "", "representation_type": "WITH_AT_LEAST", "representation_with_at_least": "2", "registered_on": "2024-11-20" } ] }, "meta": { "generated_at": "2026-09-06T22:30:00+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/companies/{regCode}/shareholders": { "get": { "operationId": "api_v1_companies_shareholders", "summary": "List shareholders", "description": "Current (non-annulled) shareholders with their holdings and votes.\n\n**Quota cost:** 1 unit per call.", "tags": [ "companies" ], "parameters": [ { "name": "regCode", "in": "path", "required": true, "description": "Registration number", "schema": { "type": "string" }, "example": "40003457109" } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "_note": "Synthetic example. Shareholders may be companies or natural persons, so the documented values are invented.", "data": { "reg_code": "40003457109", "shareholders": [ { "name": "SIA \"Paraugs Holding\"", "entity_type": "LEGAL_PERSON", "registration_number": "40000000001", "share_count": 7000, "share_percent": 70, "share_value": 1, "total_value": 7000, "currency": "EUR", "votes": 7000, "held_from": "2019-05-14", "held_to": null, "jointly_owned": false }, { "name": "Jānis Paraugs", "entity_type": "NATURAL_PERSON", "registration_number": null, "share_count": 3000, "share_percent": 30, "share_value": 1, "total_value": 3000, "currency": "EUR", "votes": 3000, "held_from": "2019-05-14", "held_to": null, "jointly_owned": false } ] }, "meta": { "generated_at": "2026-09-06T22:30:00+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/election-candidates": { "get": { "operationId": "api_v1_election_candidates_list", "summary": "Search election candidates", "description": "Candidates standing in the current Saeima election, filterable by list, region and name.\n\n**Quota cost:** 1 unit per call.", "tags": [ "election-candidates" ], "parameters": [ { "name": "q", "in": "query", "required": false, "description": "Name fragment", "schema": { "type": "string" }, "example": "Bērziņ" }, { "name": "list", "in": "query", "required": false, "description": "Candidate list slug or number", "schema": { "type": "string" }, "example": null }, { "name": "region", "in": "query", "required": false, "description": "Electoral region", "schema": { "type": "string" }, "example": "Rīga" }, { "name": "city", "in": "query", "required": false, "description": "Declared residence", "schema": { "type": "string" }, "example": null }, { "name": "has_companies", "in": "query", "required": false, "description": "Only candidates linked to companies", "schema": { "type": "boolean" }, "example": true }, { "name": "page", "in": "query", "required": false, "description": "Page number", "schema": { "type": "integer", "minimum": 1, "default": 1 }, "example": null } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": [ { "slug": "90210-andrejs-berzins", "full_name": "Andrejs Bērziņš", "first_name": "Andrejs", "last_name": "Bērziņš", "list_number": 1, "list_name": "SUVERĒNĀ VARA / APVIENĪBA JAUNLATVIEŠI", "region": "riga", "position_on_list": 22, "birth_year": 1967, "residence": "Rīga", "workplace_name": "Biedrība \"Latvijas 470/420 klašu asociācija\"", "workplace_position": "valdes priekšsēdētājs", "is_striked_out": false }, { "slug": "77980-martins-berzins", "full_name": "Mārtiņš Bērziņš", "first_name": "Mārtiņš", "last_name": "Bērziņš", "list_number": 10, "list_name": "JKP Jaunā konservatīvā partija", "region": "riga", "position_on_list": 3, "birth_year": 1983, "residence": "Mārupes novads", "workplace_name": "MBIT SIA", "workplace_position": "Valdes loceklis", "is_striked_out": false } ], "meta": { "page": 1, "per_page": 50, "count": 2, "total": 2, "total_pages": 1, "source": { "name": "Centrālā vēlēšanu komisija (CVK)", "url": "https://dati.cvk.lv/SV2026/", "disclaimer": "Information is published as submitted by the candidate, and reflects the position on the day the candidate list was filed. The candidate is responsible for its accuracy." }, "generated_at": "2026-09-14T19:22:47+02:00" }, "links": { "self": "https://api.atvertiedati.lv/v1/election-candidates?q=B%C4%93rzi%C5%86®ion=R%C4%ABga&has_companies=1&page=1", "next": null, "prev": null } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/election-candidates/lists": { "get": { "operationId": "api_v1_election_candidate_lists", "summary": "List candidate lists", "description": "The parties and alliances standing, with candidate counts and (optionally) their programmes.\n\n**Quota cost:** 1 unit per call.", "tags": [ "election-candidates" ], "parameters": [ { "name": "with_programme", "in": "query", "required": false, "description": "Include the full programme text", "schema": { "type": "boolean" }, "example": false } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "lists": [ { "number": 1, "slug": "suverena-vara--apvieniba-jaunlatviesi", "name": "SUVERĒNĀ VARA / APVIENĪBA JAUNLATVIEŠI", "candidate_count": 124, "has_programme": true, "source_url": "https://dati.cvk.lv/SV2026/kandidatu-saraksti/suverena-vara--apvieniba-jaunlatviesi" }, { "number": 2, "slug": "mes-mainam-noteikumus", "name": "\"Mēs mainām noteikumus\"", "candidate_count": 77, "has_programme": true, "source_url": "https://dati.cvk.lv/SV2026/kandidatu-saraksti/mes-mainam-noteikumus" }, { "number": 3, "slug": "politisko-partiju-apvieniba-saskanas-centrs", "name": "Politisko partiju apvienība \"Saskaņas Centrs\"", "candidate_count": 103, "has_programme": true, "source_url": "https://dati.cvk.lv/SV2026/kandidatu-saraksti/politisko-partiju-apvieniba-saskanas-centrs" } ], "regions": [ "riga", "vidzeme", "latgale" ], "source": { "name": "Centrālā vēlēšanu komisija (CVK)", "url": "https://dati.cvk.lv/SV2026/", "disclaimer": "Information is published as submitted by the candidate, and reflects the position on the day the candidate list was filed. The candidate is responsible for its accuracy." } }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/election-candidates/stats": { "get": { "operationId": "api_v1_election_candidates_stats", "summary": "Get aggregate candidate statistics", "description": "Counts and distributions across all candidates — aggregate figures only.\n\n**Quota cost:** 1 unit per call.", "tags": [ "election-candidates" ], "parameters": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "stats": { "candidates": 1428, "detailFetched": 1428, "strikedOut": 0, "withCompanyLinks": 865, "withPropertyMatches": 105, "byRegion": { "kurzeme": 172, "latgale": 180, "riga": 522, "vidzeme": 347, "zemgale": 207 }, "sourceUpdatedAt": "2026-07-31 10:42:00", "lastCheckedAt": "2026-08-04 13:45:23" }, "source": { "name": "Centrālā vēlēšanu komisija (CVK)", "url": "https://dati.cvk.lv/SV2026/", "disclaimer": "Information is published as submitted by the candidate, and reflects the position on the day the candidate list was filed. The candidate is responsible for its accuracy." } }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/election-candidates/{slug}": { "get": { "operationId": "api_v1_election_candidates_get", "summary": "Get one candidate", "description": "A candidate's public profile: their list, region, position, stated\neducation and workplaces.\n\nDeclared assets, debts and shareholdings are **not** here — those are\nunder `/v1/restricted/election-candidates/{slug}/declarations`.\n\n**Quota cost:** 1 unit per call.", "tags": [ "election-candidates" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "description": "Candidate slug", "schema": { "type": "string" }, "example": "78870-loreta-abakoka" } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "slug": "78870-loreta-abakoka", "cvk_id": "78870", "full_name": "Loreta Abakoka", "list": { "number": 9, "slug": "jauna-vienotiba", "name": "Jaunā VIENOTĪBA", "source_url": "https://dati.cvk.lv/SV2026/kandidatu-saraksti/jauna-vienotiba" }, "region": "zemgale", "position_on_list": 18, "birth_year": 2002, "residence": "Rīga", "education_level": "AUGSTĀKĀ", "education": [ { "year": 2024, "institution": "Rīgas Stradiņa universitāte", "qualification": "Sociālo zinātņu bakalaura grāds politoloģijā" } ], "workplace": { "name": "Latvijas Republikas Saeima", "position": "Deputāta palīgs" }, "is_striked_out": false, "source": { "name": "Centrālā vēlēšanu komisija (CVK)", "url": "https://dati.cvk.lv/SV2026/", "disclaimer": "Information is published as submitted by the candidate, and reflects the position on the day the candidate list was filed. The candidate is responsible for its accuracy." } }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/indices/csp-inflation": { "get": { "operationId": "api_v1_indices_csp_inflation", "summary": "Get the CSP consumer price index", "description": "The monthly consumer price index published by the Latvian Central\nStatistical Bureau, oldest month first.\n\nValues are index points on the publisher's own base, not percentages.\nTo get inflation between two months, take the ratio of their index\nvalues — do not subtract them.\n\n**Quota cost:** 1 unit per call.", "tags": [ "indices" ], "parameters": [ { "name": "from", "in": "query", "required": false, "description": "Earliest month, YYYY-MM", "schema": { "type": "string" }, "example": "2020-01" }, { "name": "to", "in": "query", "required": false, "description": "Latest month, YYYY-MM", "schema": { "type": "string" }, "example": null } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "unit": "index_points", "source": "Centrālā statistikas pārvalde", "latest": { "month": "2026-05", "index": 156.7 }, "history": [ { "month": "2020-01", "index": 109.2 }, { "month": "2020-02", "index": 109.4 }, { "month": "2020-03", "index": 109.7 } ] }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/indices/pension-capital": { "get": { "operationId": "api_v1_indices_pension_capital", "summary": "Get the pension capital distribution", "description": "How accumulated state pension capital is distributed across age groups\n— a matrix of age against capital band, with the number of people in\neach cell.\n\nAggregate counts only. Nothing here identifies an individual, which is\nwhy it is a public dataset rather than a restricted one.\n\n**Quota cost:** 1 unit per call.", "tags": [ "indices" ], "parameters": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "capital_bands": [ "0-1000", "1000-2000", "2000-3000" ], "by_age": [ { "age": 15, "bands": { "0-1000": 969, "1000-2000": 0, "2000-3000": 0, "3000-4000": 0, "4000-5000": 0, "5000-6000": 0, "6000-7000": 0, "7000-8000": 0, "8000-9000": 0, "9000-10000": 0, "10000-11000": 0, "11000-12000": 0, "12000-13000": 0, "13000-14000": 0, "14000-15000": 0, "15000-16000": 0, "16000-17000": 0, "17000-18000": 0, "18000-19000": 0, "19000-20000": 0, "20000-21000": 0, "21000-22000": 0, "22000-23000": 0, "23000-24000": 0, "24000-25000": 0, "25000-26000": 0, "26000-27000": 0, "27000-28000": 0, "28000-29000": 0, "29000-30000": 0, "30000-40000": 0, "40000-50000": 0, "50000unvairāk": 0 } }, { "age": 16, "bands": { "0-1000": 4606, "1000-2000": 0, "2000-3000": 0, "3000-4000": 0, "4000-5000": 0, "5000-6000": 0, "6000-7000": 0, "7000-8000": 0, "8000-9000": 0, "9000-10000": 0, "10000-11000": 0, "11000-12000": 0, "12000-13000": 0, "13000-14000": 0, "14000-15000": 0, "15000-16000": 0, "16000-17000": 0, "17000-18000": 0, "18000-19000": 0, "19000-20000": 0, "20000-21000": 0, "21000-22000": 0, "22000-23000": 0, "23000-24000": 0, "24000-25000": 0, "25000-26000": 0, "26000-27000": 0, "27000-28000": 0, "28000-29000": 0, "29000-30000": 0, "30000-40000": 0, "40000-50000": 0, "50000unvairāk": 0 } }, { "age": 17, "bands": { "0-1000": 8401, "1000-2000": 8, "2000-3000": 0, "3000-4000": 0, "4000-5000": 0, "5000-6000": 0, "6000-7000": 0, "7000-8000": 0, "8000-9000": 0, "9000-10000": 0, "10000-11000": 0, "11000-12000": 0, "12000-13000": 0, "13000-14000": 0, "14000-15000": 0, "15000-16000": 0, "16000-17000": 1, "17000-18000": 0, "18000-19000": 0, "19000-20000": 0, "20000-21000": 0, "21000-22000": 0, "22000-23000": 0, "23000-24000": 0, "24000-25000": 0, "25000-26000": 0, "26000-27000": 0, "27000-28000": 0, "28000-29000": 0, "29000-30000": 0, "30000-40000": 0, "40000-50000": 0, "50000unvairāk": 0 } } ] }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/nace": { "get": { "operationId": "api_v1_nace_search", "summary": "Search NACE classifiers", "description": "Search the NACE Rev. 2 classifier by code or name. Omit `q` to list top-level sections.\n\n**Quota cost:** 1 unit per call.", "tags": [ "nace" ], "parameters": [ { "name": "q", "in": "query", "required": false, "description": "Code or name fragment", "schema": { "type": "string" }, "example": "ēdināšanas" }, { "name": "per_page", "in": "query", "required": false, "description": "Results per page", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "example": 30 } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": [ { "code": "56", "name": "Ēdināšanas pakalpojumi", "parent_code": "I", "level": "division", "valid_from": "01.01.2025", "valid_to": null }, { "code": "56.1", "name": "Restorānu un mobilo ēdināšanas vietu pakalpojumi", "parent_code": "56", "level": "group", "valid_from": "01.01.2025", "valid_to": null }, { "code": "56.12", "name": "Mobilo ēdināšanas vietu pakalpojumi", "parent_code": "56.1", "level": "class", "valid_from": "01.01.2025", "valid_to": null } ], "meta": { "page": 1, "per_page": 30, "count": 6, "generated_at": "2026-09-14T19:22:47+02:00" }, "links": { "self": "https://api.atvertiedati.lv/v1/nace?q=%C4%93din%C4%81%C5%A1anas&per_page=30&page=1", "next": null, "prev": null } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/nace/tree": { "get": { "operationId": "api_v1_nace_tree", "summary": "Get the full NACE hierarchy", "description": "The complete classifier as a nested tree — sections, divisions, groups\nand classes.\n\nThis is a large, unpaginated response by design: it is meant to be\nfetched once and kept. It costs more quota than a lookup for the same\nreason, and is cached for a day.\n\n**Quota cost:** 3 units per call.", "tags": [ "nace" ], "parameters": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "tree": [ { "code": "A", "name": "LAUKSAIMNIECĪBA, MEŽSAIMNIECĪBA UN ZVEJA", "level": "section", "parent_code": null, "children": [ { "code": "01", "name": "Augkopība un lopkopība, medniecība un saistītas atbalsta darbības", "level": "division", "parent_code": "A", "children": [ { "code": "01.1", "name": "Viengadīgo kultūru audzēšana", "level": "group", "parent_code": "01", "children": [ { "code": "01.11", "name": "Graudaugu (izņemot rīsu), pākšaugu un eļļas augu sēklu audzēšana", "level": "class", "parent_code": "01.1", "children": [] }, { "code": "01.12", "name": "Rīsu audzēšana", "level": "class", "parent_code": "01.1", "children": [] }, { "code": "01.13", "name": "Dārzeņu audzēšana", "level": "class", "parent_code": "01.1", "children": [] } ] }, { "code": "01.2", "name": "Daudzgadīgo kultūru audzēšana", "level": "group", "parent_code": "01", "children": [ { "code": "01.21", "name": "Vīnogu audzēšana", "level": "class", "parent_code": "01.2", "children": [] }, { "code": "01.22", "name": "Tropu un subtropu augļu audzēšana", "level": "class", "parent_code": "01.2", "children": [] }, { "code": "01.23", "name": "Citrusaugļu audzēšana", "level": "class", "parent_code": "01.2", "children": [] } ] }, { "code": "01.3", "name": "Augu pavairošana", "level": "group", "parent_code": "01", "children": [ { "code": "01.30", "name": "Augu pavairošana", "level": "class", "parent_code": "01.3", "children": [] } ] } ] }, { "code": "02", "name": "Mežsaimniecība un mežizstrāde", "level": "division", "parent_code": "A", "children": [ { "code": "02.1", "name": "Mežkopība un citas mežsaimniecības darbības", "level": "group", "parent_code": "02", "children": [ { "code": "02.10", "name": "Mežkopība un citas mežsaimniecības darbības", "level": "class", "parent_code": "02.1", "children": [] } ] }, { "code": "02.2", "name": "Mežizstrāde", "level": "group", "parent_code": "02", "children": [ { "code": "02.20", "name": "Mežizstrāde", "level": "class", "parent_code": "02.2", "children": [] } ] }, { "code": "02.3", "name": "Meža nekoksnes produktu vākšana", "level": "group", "parent_code": "02", "children": [ { "code": "02.30", "name": "Meža nekoksnes produktu vākšana", "level": "class", "parent_code": "02.3", "children": [] } ] } ] }, { "code": "03", "name": "Zveja un akvakultūra", "level": "division", "parent_code": "A", "children": [ { "code": "03.1", "name": "Zveja", "level": "group", "parent_code": "03", "children": [ { "code": "03.11", "name": "Jūras zveja", "level": "class", "parent_code": "03.1", "children": [] }, { "code": "03.12", "name": "Saldūdens zveja", "level": "class", "parent_code": "03.1", "children": [] } ] }, { "code": "03.2", "name": "Akvakultūra", "level": "group", "parent_code": "03", "children": [ { "code": "03.21", "name": "Jūras akvakultūra", "level": "class", "parent_code": "03.2", "children": [] }, { "code": "03.22", "name": "Saldūdens akvakultūra", "level": "class", "parent_code": "03.2", "children": [] } ] }, { "code": "03.3", "name": "Zvejas un akvakultūras atbalsta darbības", "level": "group", "parent_code": "03", "children": [ { "code": "03.30", "name": "Zvejas un akvakultūras atbalsta darbības", "level": "class", "parent_code": "03.3", "children": [] } ] } ] } ] }, { "code": "B", "name": "IEGUVES RŪPNIECĪBA UN KARJERU IZSTRĀDE", "level": "section", "parent_code": null, "children": [ { "code": "05", "name": "Ogļu un lignīta ieguve", "level": "division", "parent_code": "B", "children": [ { "code": "05.1", "name": "Akmeņogļu ieguve", "level": "group", "parent_code": "05", "children": [ { "code": "05.10", "name": "Akmeņogļu ieguve", "level": "class", "parent_code": "05.1", "children": [] } ] }, { "code": "05.2", "name": "Lignīta ieguve", "level": "group", "parent_code": "05", "children": [ { "code": "05.20", "name": "Lignīta ieguve", "level": "class", "parent_code": "05.2", "children": [] } ] } ] }, { "code": "06", "name": "Jēlnaftas un dabasgāzes ieguve", "level": "division", "parent_code": "B", "children": [ { "code": "06.1", "name": "Jēlnaftas ieguve", "level": "group", "parent_code": "06", "children": [ { "code": "06.10", "name": "Jēlnaftas ieguve", "level": "class", "parent_code": "06.1", "children": [] } ] }, { "code": "06.2", "name": "Dabasgāzes ieguve", "level": "group", "parent_code": "06", "children": [ { "code": "06.20", "name": "Dabasgāzes ieguve", "level": "class", "parent_code": "06.2", "children": [] } ] } ] }, { "code": "07", "name": "Metāla rūdu ieguve", "level": "division", "parent_code": "B", "children": [ { "code": "07.1", "name": "Dzelzsrūdu ieguve", "level": "group", "parent_code": "07", "children": [ { "code": "07.10", "name": "Dzelzsrūdu ieguve", "level": "class", "parent_code": "07.1", "children": [] } ] }, { "code": "07.2", "name": "Krāsaino metālu rūdu ieguve", "level": "group", "parent_code": "07", "children": [ { "code": "07.21", "name": "Urāna un torija rūdu ieguve", "level": "class", "parent_code": "07.2", "children": [] }, { "code": "07.29", "name": "Citu krāsaino metālu rūdu ieguve", "level": "class", "parent_code": "07.2", "children": [] } ] } ] } ] }, { "code": "C", "name": "APSTRĀDES RŪPNIECĪBA", "level": "section", "parent_code": null, "children": [ { "code": "10", "name": "Pārtikas produktu ražošana", "level": "division", "parent_code": "C", "children": [ { "code": "10.1", "name": "Gaļas pārstrāde un konservēšana un gaļas produktu ražošana", "level": "group", "parent_code": "10", "children": [ { "code": "10.11", "name": "Gaļas pārstrāde un konservēšana, izņemot mājputnu gaļu", "level": "class", "parent_code": "10.1", "children": [] }, { "code": "10.12", "name": "Mājputnu gaļas pārstrāde un konservēšana", "level": "class", "parent_code": "10.1", "children": [] }, { "code": "10.13", "name": "Gaļas un mājputnu gaļas produktu ražošana", "level": "class", "parent_code": "10.1", "children": [] } ] }, { "code": "10.2", "name": "Zivju, vēžveidīgo un mīkstmiešu pārstrāde un konservēšana", "level": "group", "parent_code": "10", "children": [ { "code": "10.20", "name": "Zivju, vēžveidīgo un mīkstmiešu pārstrāde un konservēšana", "level": "class", "parent_code": "10.2", "children": [] } ] }, { "code": "10.3", "name": "Augļu un dārzeņu pārstrāde un konservēšana", "level": "group", "parent_code": "10", "children": [ { "code": "10.31", "name": "Kartupeļu pārstrāde un konservēšana", "level": "class", "parent_code": "10.3", "children": [] }, { "code": "10.32", "name": "Augļu un dārzeņu sulas ražošana", "level": "class", "parent_code": "10.3", "children": [] }, { "code": "10.39", "name": "Cita augļu un dārzeņu pārstrāde un konservēšana", "level": "class", "parent_code": "10.3", "children": [] } ] } ] }, { "code": "11", "name": "Dzērienu ražošana", "level": "division", "parent_code": "C", "children": [ { "code": "11.0", "name": "Dzērienu ražošana", "level": "group", "parent_code": "11", "children": [ { "code": "11.01", "name": "Spirtu destilēšana, rektificēšana un maisīšana", "level": "class", "parent_code": "11.0", "children": [] }, { "code": "11.02", "name": "Vīna ražošana no vīnogām", "level": "class", "parent_code": "11.0", "children": [] }, { "code": "11.03", "name": "Sidra un citu raudzētu augļu dzērienu ražošana", "level": "class", "parent_code": "11.0", "children": [] } ] } ] }, { "code": "12", "name": "Tabakas izstrādājumu ražošana", "level": "division", "parent_code": "C", "children": [ { "code": "12.0", "name": "Tabakas izstrādājumu ražošana", "level": "group", "parent_code": "12", "children": [ { "code": "12.00", "name": "Tabakas izstrādājumu ražošana", "level": "class", "parent_code": "12.0", "children": [] } ] } ] } ] } ], "total": 1047 }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/nace/{code}": { "get": { "operationId": "api_v1_nace_get", "summary": "Get one NACE classifier", "description": "A single classifier with its immediate children.\n\n**Quota cost:** 1 unit per call.", "tags": [ "nace" ], "parameters": [ { "name": "code", "in": "path", "required": true, "description": "Classifier code", "schema": { "type": "string" }, "example": "56.1" } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "code": "56.1", "name": "Restorānu un mobilo ēdināšanas vietu pakalpojumi", "parent_code": "56", "level": "group", "valid_from": "01.01.2025", "valid_to": null, "children": [ { "code": "56.11", "name": "Restorānu pakalpojumi", "parent_code": "56.1", "level": "class", "valid_from": "01.01.2025", "valid_to": null }, { "code": "56.12", "name": "Mobilo ēdināšanas vietu pakalpojumi", "parent_code": "56.1", "level": "class", "valid_from": "01.01.2025", "valid_to": null } ] }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/prices/electricity/plans": { "get": { "operationId": "api_v1_prices_electricity_plans", "summary": "List household electricity plans", "description": "Currently advertised household electricity offers from Latvian traders.\n\nTwo plan types, and they are **not comparable on a single number**:\n\n- `fixed` — `energy_price` is the whole per-kWh rate for the contract term.\n- `dynamic` — `energy_price` is only the trader's margin **on top of** the\n Nord Pool spot price. On its own it is not what anyone pays.\n\nA plan with a low rate and a high monthly fee only beats its rival above\nsome level of consumption, so ranking these requires a consumption\nassumption. All prices exclude VAT.\n\n**Quota cost:** 1 unit per call.", "tags": [ "prices" ], "parameters": [ { "name": "provider", "in": "query", "required": false, "description": "Restrict to one trader", "schema": { "type": "string" }, "example": "elektrum" }, { "name": "plan_type", "in": "query", "required": false, "description": "Restrict to one plan type", "schema": { "type": "string", "enum": [ "fixed", "dynamic" ] }, "example": "fixed" } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "currency": "EUR", "vat_included": false, "plans": [] }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/prices/electricity/spot-history": { "get": { "operationId": "api_v1_prices_electricity_spot", "summary": "Get Nord Pool spot price history", "description": "Daily average Nord Pool LV day-ahead prices, excluding VAT.\n\n**Quota cost:** 1 unit per call.", "tags": [ "prices" ], "parameters": [ { "name": "days", "in": "query", "required": false, "description": "Days of history", "schema": { "type": "integer", "minimum": 1, "maximum": 730, "default": 30 }, "example": 30 } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "days": 30, "currency": "EUR", "unit": "kWh", "vat_included": false, "average_price_per_kwh": null, "daily_averages": [] }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/prices/fuel/history": { "get": { "operationId": "api_v1_prices_fuel_history", "summary": "Get fuel price history", "description": "Daily prices for one station and fuel type over a trailing window.\n\n**Quota cost:** 1 unit per call.", "tags": [ "prices" ], "parameters": [ { "name": "station", "in": "query", "required": true, "description": "Station chain name", "schema": { "type": "string" }, "example": "Neste" }, { "name": "fuel_type", "in": "query", "required": false, "description": "Fuel type", "schema": { "type": "string", "default": "e95" }, "example": "e95" }, { "name": "days", "in": "query", "required": false, "description": "Days of history", "schema": { "type": "integer", "minimum": 1, "maximum": 730, "default": 30 }, "example": 30 } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "station": "Neste", "fuel_type": "e95", "days": 30, "currency": "EUR", "unit": "litre", "vat_included": true, "prices": [] }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/prices/fuel/latest": { "get": { "operationId": "api_v1_prices_fuel_latest", "summary": "Get the latest fuel prices", "description": "Today's advertised pump prices at the major Latvian fuel chains,\ngrouped by fuel type and sorted cheapest first.\n\n`change` is the movement against the previous published day, in EUR per\nlitre; it is `null` when there is no previous day to compare against.\n\n**Quota cost:** 1 unit per call.", "tags": [ "prices" ], "parameters": [ { "name": "fuel_type", "in": "query", "required": false, "description": "Restrict to a single fuel type", "schema": { "type": "string" }, "example": "e95" } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "currency": "EUR", "unit": "litre", "vat_included": true, "fuel_types": { "e95": [ { "station": "Neste", "price": 1.757, "change": -0.04, "price_date": "2026-06-14" }, { "station": "Virši", "price": 1.797, "change": 0, "price_date": "2026-06-14" } ] }, "updated_at": "2026-06-14T14:21:26+02:00" }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/rates/euribor/history": { "get": { "operationId": "api_v1_rates_euribor_history", "summary": "Get Euribor rate history", "description": "Daily Euribor fixings over a trailing window, newest first.\n\n**Quota cost:** 1 unit per call.", "tags": [ "rates" ], "parameters": [ { "name": "days", "in": "query", "required": false, "description": "Days of history", "schema": { "type": "integer", "minimum": 1, "maximum": 3650, "default": 365 }, "example": 365 } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "days": 365, "unit": "percent", "rates": [ { "date": "2026-06-09", "one_week": 1.871, "one_month": 2.063, "three_month": 2.373, "six_month": 2.606, "twelve_month": 2.866 }, { "date": "2026-06-12", "one_week": 1.928, "one_month": 2.167, "three_month": 2.38, "six_month": 2.639, "twelve_month": 2.874 } ] }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/rates/euribor/latest": { "get": { "operationId": "api_v1_rates_euribor_latest", "summary": "Get the latest Euribor rates", "description": "The most recent published Euribor fixings across all standard tenors, in percent.\n\n**Quota cost:** 1 unit per call.", "tags": [ "rates" ], "parameters": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "date": "2026-06-12", "one_week": 1.928, "one_month": 2.167, "three_month": 2.38, "six_month": 2.639, "twelve_month": 2.874 }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/real-estate/addresses": { "get": { "operationId": "api_v1_real_estate_addresses", "summary": "Search property addresses", "description": "Address cards from the property register, searchable by address prefix and city.\n\n**Quota cost:** 1 unit per call.", "tags": [ "real-estate" ], "parameters": [ { "name": "q", "in": "query", "required": false, "description": "Address prefix", "schema": { "type": "string" }, "example": "Brīvības iela 1" }, { "name": "city", "in": "query", "required": false, "description": "Restrict to one city", "schema": { "type": "string" }, "example": "Rīga" }, { "name": "page", "in": "query", "required": false, "description": "Page number", "schema": { "type": "integer", "minimum": 1, "default": 1 }, "example": null }, { "name": "per_page", "in": "query", "required": false, "description": "Results per page", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "example": 50 } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": [ { "id": 42604, "address": "Brīvības iela 100B - 19, Rīga, LV-1001", "street": "Brīvības iela", "street_number": "100B", "flat_number": "19", "city": "Rīga", "postal_code": "LV-1001" }, { "id": 25583, "address": "Brīvības iela 101, Rīga, LV-1001", "street": "Brīvības iela", "street_number": "101", "flat_number": null, "city": "Rīga", "postal_code": "LV-1001" }, { "id": 11984, "address": "Brīvības iela 103 - 15, Rīga, LV-1001", "street": "Brīvības iela", "street_number": "103", "flat_number": "15", "city": "Rīga", "postal_code": "LV-1001" } ], "meta": { "page": 1, "per_page": 50, "count": 50, "total": 85, "total_pages": 2, "generated_at": "2026-09-14T19:22:47+02:00" }, "links": { "self": "https://api.atvertiedati.lv/v1/real-estate/addresses?q=Br%C4%ABv%C4%ABbas+iela+1&city=R%C4%ABga&per_page=50&page=1", "next": "https://api.atvertiedati.lv/v1/real-estate/addresses?q=Br%C4%ABv%C4%ABbas+iela+1&city=R%C4%ABga&per_page=50&page=2", "prev": null } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/real-estate/addresses/{id}/transactions": { "get": { "operationId": "api_v1_real_estate_address_transactions", "summary": "List transactions at an address", "description": "Every recorded transaction at one address card, newest first.\n\n**Quota cost:** 1 unit per call.", "tags": [ "real-estate" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Address card id", "schema": { "type": "integer" }, "example": 36947 } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "address_id": 36947, "transactions": [ { "id": 49559, "trade_date": "2024-07-23", "trade_amount": 4600, "price_per_unit": null, "currency": "EUR", "property_type": "other", "registry_code": null, "location": { "address": "\"1. masīvs 263\", Kalnciema pag., Jelgavas nov., LV-3016", "street": null, "street_number": null, "flat_number": null, "city": null } } ] }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/real-estate/business-addresses": { "get": { "operationId": "api_v1_real_estate_business_addresses", "summary": "Search business addresses", "description": "Registered company addresses, with a count of active companies at each\n— the endpoint behind \"how many businesses share this address\".\n\nThis is a **separate list** from `/real-estate/addresses`: company\naddresses are stored as the company registry writes them, which does not\nreliably match the cadastral address register. Keeping the two apart is\ndeliberate; joining them would produce confident but wrong matches.\n\n**Quota cost:** 1 unit per call.", "tags": [ "real-estate" ], "parameters": [ { "name": "q", "in": "query", "required": false, "description": "Address fragment", "schema": { "type": "string" }, "example": "Brīvības iela" }, { "name": "page", "in": "query", "required": false, "description": "Page number", "schema": { "type": "integer", "minimum": 1, "default": 1 }, "example": null }, { "name": "per_page", "in": "query", "required": false, "description": "Results per page", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "example": 50 } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": [ { "id": 4215, "address": "Rīga, Brīvības iela 137", "active_company_count": 31 }, { "id": 143247, "address": "Rīga, Brīvības iela 155A", "active_company_count": 19 }, { "id": 9003, "address": "Rīga, Brīvības iela 40 - 43", "active_company_count": 18 } ], "meta": { "page": 1, "per_page": 50, "count": 50, "total": 3837, "total_pages": 77, "generated_at": "2026-09-14T19:22:47+02:00" }, "links": { "self": "https://api.atvertiedati.lv/v1/real-estate/business-addresses?q=Br%C4%ABv%C4%ABbas+iela&per_page=50&page=1", "next": "https://api.atvertiedati.lv/v1/real-estate/business-addresses?q=Br%C4%ABv%C4%ABbas+iela&per_page=50&page=2", "prev": null } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/real-estate/business-addresses/{id}/companies": { "get": { "operationId": "api_v1_real_estate_address_companies", "summary": "List companies at a business address", "description": "Active companies registered at one business address.\n\n**Quota cost:** 1 unit per call.", "tags": [ "real-estate" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Business address id", "schema": { "type": "integer" }, "example": 1 } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "address_id": 1, "companies": [] }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/real-estate/stats/city-averages": { "get": { "operationId": "api_v1_real_estate_city_averages", "summary": "Get monthly average prices by city", "description": "Pre-aggregated monthly transaction statistics per city — count, average, median and range.\n\n**Quota cost:** 2 units per call.", "tags": [ "real-estate" ], "parameters": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "currency": "EUR", "cities": [] }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/real-estate/transactions": { "get": { "operationId": "api_v1_real_estate_transactions", "summary": "Search property transactions", "description": "Registered property sale transactions, newest first.\n\n**At least one of `city`, `street`, `type` or `date_from` is required.**\nWithout a filter this query scans the whole transaction history, so it\nis refused rather than served slowly.\n\n`meta.total` is present only when the filters are selective enough for\nan exact count to be cheap. When it is absent, page forward with\n`links.next`.\n\nOn the Free plan, results are limited to a trailing window of recent\nmonths; the applied window is reported in `meta.history_window_months`.\n\n`type` is matched exactly against the register's own vocabulary, which\nis terse: `Dz` (apartment), `T` (land plot), `Ēkas` (buildings),\n`Zeme ar ēkām` (land with buildings), `Inženierbūves`, and `other`. An\nunrecognised value is a `400`, not an empty page.\n\n**Quota cost:** 2 units per call.", "tags": [ "real-estate" ], "parameters": [ { "name": "city", "in": "query", "required": false, "description": "City name, exact match", "schema": { "type": "string" }, "example": "Rīga" }, { "name": "street", "in": "query", "required": false, "description": "Street name prefix", "schema": { "type": "string" }, "example": "Brīvības" }, { "name": "type", "in": "query", "required": false, "description": "Property type, as the register writes it", "schema": { "type": "string" }, "example": "Dz" }, { "name": "date_from", "in": "query", "required": false, "description": "Earliest trade date, YYYY-MM-DD", "schema": { "type": "string" }, "example": "2020-01-01" }, { "name": "date_to", "in": "query", "required": false, "description": "Latest trade date, YYYY-MM-DD", "schema": { "type": "string" }, "example": null }, { "name": "price_min", "in": "query", "required": false, "description": "Minimum trade amount, EUR", "schema": { "type": "integer", "minimum": 0 }, "example": null }, { "name": "price_max", "in": "query", "required": false, "description": "Maximum trade amount, EUR", "schema": { "type": "integer", "minimum": 0 }, "example": null }, { "name": "page", "in": "query", "required": false, "description": "Page number", "schema": { "type": "integer", "minimum": 1, "default": 1 }, "example": 1 }, { "name": "per_page", "in": "query", "required": false, "description": "Results per page", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "example": 50 } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": [ { "id": 66272, "trade_date": "2026-06-01", "trade_amount": 59700, "price_per_unit": 1836.92, "currency": "EUR", "property_type": "Dz", "registry_code": "07", "location": { "address": "Brīvības gatve 386 k-1 - 41, Rīga, LV-1024", "street": "Brīvības gatve", "street_number": "386", "flat_number": "41", "city": "Rīga" } }, { "id": 66140, "trade_date": "2026-06-01", "trade_amount": 66500, "price_per_unit": 1242.99, "currency": "EUR", "property_type": "Dz", "registry_code": "07", "location": { "address": "Brīvības gatve 430 - 60, Rīga, LV-1024", "street": "Brīvības gatve", "street_number": "430", "flat_number": "60", "city": "Rīga" } }, { "id": 66302, "trade_date": "2026-05-28", "trade_amount": 115000, "price_per_unit": 2290.84, "currency": "EUR", "property_type": "Dz", "registry_code": "07", "location": { "address": "Brīvības gatve 386 k-3 - 48, Rīga, LV-1024", "street": "Brīvības gatve", "street_number": "386", "flat_number": "48", "city": "Rīga" } } ], "meta": { "page": 1, "per_page": 50, "count": 50, "total": 354, "total_pages": 8, "generated_at": "2026-09-14T19:22:47+02:00" }, "links": { "self": "https://api.atvertiedati.lv/v1/real-estate/transactions?city=R%C4%ABga&street=Br%C4%ABv%C4%ABbas&type=Dz&date_from=2020-01-01&page=1&per_page=50", "next": "https://api.atvertiedati.lv/v1/real-estate/transactions?city=R%C4%ABga&street=Br%C4%ABv%C4%ABbas&type=Dz&date_from=2020-01-01&page=2&per_page=50", "prev": null } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } }, "/v1/real-estate/transactions/{id}": { "get": { "operationId": "api_v1_real_estate_transaction", "summary": "Get one transaction", "description": "Full detail for a single transaction, including the building, land and\npremise records the source published alongside it.\n\nThose three are nested rather than separately addressable because that\nis what the source data is — per-transaction detail, not registries you\ncan look a cadastral number up in.\n\n**Quota cost:** 1 unit per call.", "tags": [ "real-estate" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Transaction id", "schema": { "type": "integer" }, "example": 31407 } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" }, "example": { "data": { "id": 31407, "trade_date": "1998-02-19", "trade_amount": 1849.73, "price_per_unit": null, "currency": "EUR", "property_type": "Zeme ar ēkām", "registry_code": null, "location": { "address": "\"Reņģes\", Sesavas pag., Jelgavas nov., LV-3034", "street": null, "street_number": null, "flat_number": null, "city": null, "postal_code": "LV-3034", "municipality": "Sesavas pag.", "region": "Jelgavas nov." }, "registry_codes": [ "101(19000)" ], "building": { "qty": 2, "registry_description": "54740060037001", "shares": 1, "total": 1, "storey_total": 1, "land_area": 70.1, "total_area": 53.2, "volume": 201, "year": null, "wear_and_tear": "60", "trade_registry_description": null }, "land": { "reg_no": "54740060037", "shares": 0, "total": null, "area_sold": 0, "registry_code_top_by_land": "0101", "land_unit_count": 1, "land_unit_total": 1 }, "premise": { "count": 0, "flat_count": 0, "group_registry_description": null, "count_shares": 0, "count_total": 0, "usage_registry_code": null, "lowest_floor": 0, "highest_floor": 0, "total_area": 0, "flat_total_area": 0, "total_unit_count": 0, "room_count": 0, "comment": null } }, "meta": { "generated_at": "2026-09-14T19:22:47+02:00" } } } }, "headers": { "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests left in the current minute" }, "X-Quota-Remaining": { "schema": { "type": "integer" }, "description": "Quota units left this month" } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } } } } }, "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-Api-Key" } }, "schemas": { "Envelope": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "description": "An array for collections, an object for single resources. Never null.", "oneOf": [ { "type": "array" }, { "type": "object" } ] }, "meta": { "$ref": "#/components/schemas/Meta" }, "links": { "$ref": "#/components/schemas/Links" } } }, "Meta": { "type": "object", "properties": { "page": { "type": "integer" }, "per_page": { "type": "integer" }, "count": { "type": "integer", "description": "Items in this response" }, "total": { "type": "integer", "description": "Absent when an exact count is not available cheaply" }, "total_pages": { "type": "integer" }, "generated_at": { "type": "string", "format": "date-time" } } }, "Links": { "type": "object", "properties": { "self": { "type": "string", "format": "uri" }, "next": { "type": [ "string", "null" ], "format": "uri" }, "prev": { "type": [ "string", "null" ], "format": "uri" } } }, "Error": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "docs" ], "properties": { "code": { "type": "string", "description": "Stable machine-readable error code" }, "message": { "type": "string" }, "docs": { "type": "string", "format": "uri" }, "request_id": { "type": "string" } } } } } }, "responses": { "BadRequest": { "description": "Invalid or unknown parameter", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "Unauthorized": { "description": "Missing or invalid API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "Forbidden": { "description": "Key scope, plan or data processing agreement does not permit this dataset", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "TooManyRequests": { "description": "Rate limit or monthly quota exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait" } } } } } }