{ "openapi": "3.0.0", "info": { "title": "ownr API", "description": "Danish company (CVR), person and property data, plus the follows, Ajour lists, segments and pipelines of your ownr account.\n\nBase URL: `https://ownr.dk/api/v2`. Requests and responses are JSON. Add `?pretty=1` to pretty-print a response.\n\n## Authentication\n\nThe API uses OAuth 2.0 **client credentials**.\n\n1. Every user of the company creates their own key in ownr+ under **API Access** (https://ownr.dk/users/api-access) and copies its **Client ID** and **Client secret**. A key follows the license of its owner: what a user may see on ownr, their key sees in the API. For a system such as a CRM or ERP, an administrator creates an **integration key** there: it belongs to the company rather than an employee, so it keeps working when people leave, and it sees what the license given to it allows.\n2. Get a token:\n\n curl -X POST https://ownr.dk/api/v2/token \\\n -d grant_type=client_credentials \\\n -d client_id=CLIENT_ID \\\n -d client_secret=CLIENT_SECRET\n\n The client id and secret may also be sent as HTTP Basic authentication. A token is valid for 1 hour (`expires_in: 3600`). Request a new one when it expires. Token requests do not count against your quota.\n3. Send the token on every call: `Authorization: Bearer ACCESS_TOKEN`.\n\n## Scopes\n\nA scope decides whether your API access may call an endpoint at all. Each endpoint in this reference lists the scope it needs. A token without it gets `403`.\n\n| Scope | Endpoints |\n|---|---|\n| `companies` | `/company/…`, `/p-unit/…`, `/report/…`, `/company/segments`, `/account/followed/companies` |\n| `persons` | `/person/…`, `/person/segments`, `/account/followed/persons` |\n| `properties` | `/property/…`, `/property/segments`, `/account/followed/properties` |\n| `ajour` | `/company/{cvr}/ajour`, `/person/{itemId}/ajour`, `/property/{dafId}/ajour`, `/account/ajour/…` |\n| `pipeline` | `/pipelines/…` |\n| any of `companies`, `persons`, `properties` | `/segments/downloads…` |\n| `companies` or `persons` | `/beneficial-owners/purposes` |\n\nFollowing is part of each entity's scope. There is no separate follow scope.\n\nAPI access gets `companies`, `persons`, `properties`, `ajour` and `pipeline` when it is activated. Endpoints that need a purchase still check it: Ajour answers `402` without a license or a purchased Ajour, Pipeline answers `402` when there is no lead capacity left, and purchased segments answer `402` until they are paid.\n\n## Your plan decides what you see\n\nThe scope decides *whether* you can call an endpoint. Your ownr plan (Insights Free, Insights All or Premium) decides *how much* of the answer you get.\n\n- Fields your plan does not include are `null`, and the object that holds them lists their names in `restricted`, e.g. `\"restricted\": [\"tinglysning\", \"access_holders\"]`. A `null` field not listed there is genuinely empty. Fields and filters that need Premium are marked **(Premium)** in this reference.\n- Segment filters your plan does not include are ignored, so the `count` reflects only the filters your plan covers. If every filter is ignored, the answer is `400 No filters supplied`.\n- Beneficial owners also require `beneficial_purpose` and `beneficial_accept=1`. See `GET /beneficial-owners/purposes`.\n\nThe plan can change without a new token: after an upgrade or downgrade, the next call returns the new set of fields.\n\n## Quota and rate limits\n\n- Your company has **one call quota**, shared by all its keys. The free tier has 1,000 calls a month, from the day API access was activated (if that day doesn't exist in a month, the quota resets on the 1st of the next month, and on the 1st from then on). A paid tier (5,000 to 1,000,000 calls) resets monthly on its billing day, also when it is paid yearly. An administrator buys or upgrades the tier in ownr+ › API; an upgrade applies at once, and calls already used in the period stay counted.\n- **Counted:** successful (`2xx`) calls to data endpoints: `/company`, `/p-unit`, `/report`, `/person`, `/property`, the segment filter lookups and `/beneficial-owners/purposes`. MCP calls to these endpoints count the same way.\n- **Not counted:** errors (`4xx`, `5xx`, `429`), `/token`, `/pipelines…`, follow, Ajour, `/account/…`, `/segments/downloads…` and webhook deliveries.\n- When the quota is used up, the counted endpoints answer `429` with an `upgrade_url` until it resets. The endpoints that are not counted keep working. The company's administrators get an e-mail at 80% and 100% of the quota.\n- There is also an hourly limit, which every call counts towards: 300 on the free tier, and 1,000 to 60,000 on the paid tiers.\n\nThe counted endpoints carry the quota headers, and every response carries the hourly ones:\n\n| Header | Meaning |\n|---|---|\n| `X-Quota-Limit` | Calls included in the current quota period |\n| `X-Quota-Remaining` | Calls left in the current quota period |\n| `X-Quota-Reset` | When the quota resets (ISO 8601) |\n| `X-RateLimit-Limit` | Calls allowed in the current hour |\n| `X-RateLimit-Remaining` | Calls left in the current hour |\n| `X-RateLimit-Reset` | Seconds until the hourly limit resets |\n\nA `429` answer also has a `Retry-After` header (seconds) and says in `error.message` whether the quota or the hourly limit was hit.\n\n## Responses and errors\n\nA success is `{\"status\": \"success\", \"data\": …}`.\nAn error is `{\"status\": \"error\", \"error\": {\"code\": , \"message\": \"…\"}}`. A `402` adds keys such as `capacity` or `checkout_url`.\n\n| Code | Meaning |\n|---|---|\n| `400` | Invalid input, e.g. an unknown query parameter on a segment endpoint, or a search query shorter than 3 characters |\n| `401` | Missing, invalid or expired token |\n| `402` | Payment or capacity needed: unpaid segment, no lead capacity, Ajour without a license or a purchased Ajour. The body links to where to buy |\n| `403` | The token does not have the scope the endpoint needs |\n| `404` | Not found. Data that belongs to another company is also `404` |\n| `409` | Conflict, e.g. the item is already in the list |\n| `429` | Quota or hourly limit reached |\n\n## Lists and paging\n\nPaged answers have `items`, `count`, `page`, `pageCount`, `nextPageUrl` and `prevPageUrl`. Use `page` to move through them.\n\n- **Search** (`/…/search`) is for finding a specific entity, not for exporting lists. `q` takes 3 to 100 characters, `limit` 1 to 10 results per page, and a search has at most 10 pages: past page 10, `items` is empty and only `count` is given.\n- **Segment filter lookups** (`/…/segments`) return the total `count` and up to 3 example items.\n- **Full lists** come from a purchased segment: buy it in ownr, then read it with `GET /segments/downloads/{id}`, 20 rows per page. A purchased segment can be downloaded for 3 years (for a subscription, 3 years from when the subscription ends).\n\n## IDs and references\n\n| Entity | ID |\n|---|---|\n| Company | CVR number (integer) |\n| Production unit | P-number |\n| Person | ownr person id |\n| Property | DAF id (string) |\n| Annual report | Report id |\n\nEvery reference to another entity uses the same `item` object: `{\"id\", \"slug\", \"url\", \"name\"}`. `url` is the API path to fetch it.\n\n## Data freshness\n\nownr imports data from the public registers (CVR, BBR, Tinglysning, Statstidende, annual reports) in batches. Answers are as fresh as the latest import, not real time.\n\n## Webhooks\n\nownr sends a webhook when something changes on a company, person or property in your **Ajour** list, and when items enter or leave a **segment you subscribe to**. Followed items give notifications in ownr, not webhooks.\n\nDeliveries are signed with `X-Ownr-Signature` when signing is turned on under API Access (on by default for new organisations). Up to 3 attempts are made per event. Events, payloads and how to verify the signature: https://ownr.dk/pages/v2-webhooks-docs", "version": "2.0" }, "servers": [ { "url": "https://ownr.dk/api/v2" } ], "paths": { "/company/search": { "get": { "tags": [ "company" ], "summary": "Search company by name", "operationId": "searchCompany", "parameters": [ { "name": "q", "in": "query", "description": "Company name, 3 to 100 characters", "required": true, "schema": { "type": "string", "maxLength": 100, "minLength": 3 } }, { "name": "page", "in": "query", "description": "Page number. A search has at most 10 pages: past page 10, `items` is empty and only `count` is given", "schema": { "type": "integer", "default": 1 } }, { "name": "limit", "in": "query", "description": "Results per page", "schema": { "type": "integer", "default": 10, "maximum": 10, "minimum": 1 } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "items": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/CompanySummary" }, "status": { "type": "string", "example": "AKTIV" }, "address": { "oneOf": [ { "$ref": "#/components/schemas/PropertySummary" } ], "nullable": true } }, "type": "object" } }, "count": { "description": "The total number of records in the result set", "type": "integer", "example": 2 }, "page": { "description": "The current page displayed", "type": "integer", "example": 1 }, "pageCount": { "description": "Total number of pages", "type": "integer", "example": 1 }, "nextPageUrl": { "type": "string", "example": null, "nullable": true }, "prevPageUrl": { "type": "string", "example": null, "nullable": true } }, "type": "object" } }, "type": "object" } } } }, "400": { "description": "Empty query supplied", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Empty query supplied", "properties": { "status": { "type": "string", "default": "error" }, "error": { "properties": { "code": { "type": "integer", "default": 400 }, "message": { "type": "string", "default": "Empty query supplied" } }, "type": "object" } }, "type": "object" } } } } }, "security": [ { "oauth2": [ "companies" ] } ] } }, "/company/{cvr}": { "get": { "tags": [ "company" ], "summary": "Find company by cvr", "description": "Without `include`, the whole profile comes back: management (`relations`), owners, properties, subsidiaries and the list of annual reports. With `include`, only the basic data and the parts named in it, which is faster. One call counts once in the quota, whatever is included. The included parts follow the license, as everywhere: property addresses and Tinglysning only with Premium.", "operationId": "companyGet", "parameters": [ { "name": "cvr", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "include", "in": "query", "description": "Comma-separated parts to return with the basic data: `management`, `owners`, `subsidiaries`, `properties`, `financials` (the key figures of the latest annual report and the year before, plus the list of reports)", "schema": { "type": "string", "example": "management,owners,subsidiaries,properties,financials" } }, { "$ref": "#/components/parameters/beneficial_purpose" }, { "$ref": "#/components/parameters/beneficial_accept" } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "id": { "type": "integer", "format": "int64", "example": 36473606 }, "slug": { "type": "string", "default": "company" }, "url": { "type": "string", "example": "/api/v2/company/36473606" }, "name": { "type": "string", "example": "WEB CODERS ApS" }, "type": { "properties": { "code": { "type": "integer", "example": 80 }, "longDescription": { "type": "string", "example": "Anpartsselskab" }, "shortDescription": { "type": "string", "example": "APS" } }, "type": "object", "nullable": true }, "status": { "type": "string", "enum": [ "AKTIV", "UNDER FRIVILLIG LIKVIDATION", "UNDER REKONSTRUKTION", "UNDER KONKURS", "UNDER TVANGSOPLØSNING", "UNDER REASSUMERING", "UDEN RETSVIRKNING", "FREMTID", "UNDER REASSUMERING", "OPHØRT", "OPLØST EFTER FRIVILLIG LIKVIDATION", "OPLØST EFTER ERKLÆRING", "TVANGSOPLØST", "OPLØST EFTER FUSION", "OPLØST EFTER SPALTNING", "OPLØST EFTER KONKURS", "SLETTET", "OPLØST", "OPLØST EFTER GRÆNSEOVERSKRIDENDE FUSION", "OPLØST EFTER GRÆNSEOVERSKRIDENDE HJEMSTEDSFLYTNING" ], "example": "AKTIV" }, "start_date": { "type": "string", "format": "date", "example": "2014-12-19" }, "effective_date": { "type": "string", "format": "date", "example": "2015-01-01" }, "ceased_date": { "type": "string", "format": "date", "example": "2014-12-19", "nullable": true }, "advertising_protected": { "type": "boolean", "example": true }, "basic_data": { "properties": { "address": { "oneOf": [ { "$ref": "#/components/schemas/PropertySummary" } ], "nullable": true }, "registered_capital": { "properties": { "amount": { "type": "integer", "example": 51000 }, "currency": { "type": "string", "default": "DKK" } }, "type": "object" }, "secondary_names": { "type": "array", "items": { "type": "string" }, "example": [ "WEBCODERS ApS", "NERDS ON FIRE ApS", "WECRAWL ApS" ] }, "sector": { "properties": { "code": { "type": "string", "example": "620100" }, "text": { "type": "string", "default": "Computerprogrammering" } }, "type": "object", "nullable": true }, "secondary_sectors": { "type": "array", "items": { "properties": { "code": { "type": "string", "example": "620200" }, "text": { "type": "string", "example": "Konsulentbistand vedrørende informationsteknologi" } }, "type": "object" } }, "production_units": { "description": "Only p-number and a link — see GET /p-unit/{p_number} for full data, or GET /company/{cvr}/p-units to list them all at once", "type": "array", "items": { "properties": { "p_number": { "type": "string", "example": "1030715892" }, "url": { "type": "string", "example": "/api/v2/p-unit/1030715892" } }, "type": "object" } }, "employees_number": { "properties": { "number": { "type": "integer", "example": 1 }, "fte": { "description": "Full time equivalent", "type": "integer", "example": 1 }, "year": { "type": "integer", "example": 2022 }, "month": { "type": "integer", "example": 5 } }, "type": "object", "nullable": true }, "contacts": { "type": "array", "items": { "type": "string" }, "example": [ "36965136", "sales@webcoders.dk" ] }, "financial_year": { "properties": { "from": { "type": "string", "example": "--01-01" }, "to": { "type": "string", "example": "--12-31" } }, "type": "object", "nullable": true }, "first_accounting_period": { "properties": { "from": { "type": "string", "format": "date", "example": "2015-01-01" }, "to": { "type": "string", "format": "date", "example": "2015-12-31" } }, "type": "object", "nullable": true }, "powers_to_bind": { "type": "string", "example": "Selskabet tegnes af Mick Stjernelykke og Per Thomas Frost." }, "objectives": { "type": "string", "example": "Selskabets formål er at drive virksomhed med udvikling og salg af software samt IT services og dermed forbundet virksomhed." } }, "type": "object" }, "relations": { "properties": { "directors": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/PersonSummary" }, "notes": { "type": "string", "example": "" } }, "type": "object" } }, "board_members": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/PersonSummary" }, "notes": { "type": "string", "example": "" } }, "type": "object" } }, "auditors": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/PersonSummary" }, "notes": { "type": "string", "example": "" } }, "type": "object" } }, "store_managers": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/PersonSummary" }, "notes": { "type": "string", "example": "" } }, "type": "object" } }, "representatives": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/PersonSummary" }, "notes": { "type": "string", "example": "" } }, "type": "object" } } }, "type": "object" }, "owners": { "properties": { "legal": { "type": "array", "items": { "properties": { "item": { "oneOf": [ { "$ref": "#/components/schemas/CompanySummary" }, { "$ref": "#/components/schemas/PersonSummary" } ] }, "notes": { "type": "string", "example": "33.34-49.99%" } }, "type": "object" } }, "beneficial": { "description": "Requires `beneficial_purpose` and `beneficial_accept=1`. Without them, with an invalid purpose or when beneficial owners are not enabled for your account, the array holds a single notice item with `item.slug` = `beneficial_owners_purposes`, `item.url` pointing to `/beneficial-owners/purposes` and the reason in `notes`, e.g. `To see beneficial owners pass beneficial_purpose and beneficial_accept=1. Allowed purposes: /api/v2/beneficial-owners/purposes` or `Beneficial owners are not enabled for your account.`", "type": "array", "items": { "properties": { "item": { "oneOf": [ { "$ref": "#/components/schemas/CompanySummary" }, { "$ref": "#/components/schemas/PersonSummary" } ] }, "notes": { "type": "string", "example": "33.34-49.99%" } }, "type": "object" } }, "ultimate": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/PersonSummary" }, "notes": { "type": "string", "example": "" } }, "type": "object" } } }, "type": "object" }, "properties": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/PropertySummary" }, "notes": { "type": "string", "example": "" } }, "type": "object" } }, "subsidiaries": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/CompanySummary" }, "notes": { "type": "string", "example": "33.34-49.99%" } }, "type": "object" } }, "reports": { "type": "array", "items": { "properties": { "id": { "type": "integer", "example": 32369891 }, "slug": { "type": "string", "default": "report" }, "url": { "type": "string", "example": "/api/v2/report/32369891" }, "title": { "type": "string", "example": "2021" }, "start_date": { "type": "string", "format": "date", "example": "2020-01-01" }, "end_date": { "type": "string", "format": "date", "example": "2021-12-31" } }, "type": "object" } }, "financials": { "description": "Only with `include=financials`. Null when the company has no annual report with key figures", "properties": { "report": { "properties": { "id": { "type": "integer", "example": 32369891 }, "url": { "type": "string", "example": "/api/v2/report/32369891" }, "title": { "type": "string", "example": "2025" }, "start_date": { "type": "string", "format": "date", "example": "2025-01-01" }, "end_date": { "type": "string", "format": "date", "example": "2025-12-31" } }, "type": "object" }, "unit": { "description": "As in `/report/{itemId}`: `' DKK` means thousands of DKK", "type": "string", "example": "' DKK" }, "figures": { "description": "Each figure of the latest report, and the same figure of the report before it (null without one)", "properties": { "ProfitLossBeforeTax": { "$ref": "#/components/schemas/ReportFigure" }, "Equity": { "$ref": "#/components/schemas/ReportFigure" }, "GrossProfit": { "$ref": "#/components/schemas/ReportFigure" }, "EmployeeBenefitsExpense": { "$ref": "#/components/schemas/ReportFigure" }, "LiabilitiesOtherThanProvisions": { "$ref": "#/components/schemas/ReportFigure" }, "Receivables": { "$ref": "#/components/schemas/ReportFigure" } }, "type": "object" } }, "type": "object", "nullable": true } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "companies" ] } ] } }, "/beneficial-owners/purposes": { "get": { "tags": [ "beneficial owners" ], "summary": "List purposes allowed for beneficial owners lookup", "description": "Pass a purpose `code` as `beneficial_purpose` together with `beneficial_accept=1` to `/company/{cvr}` or `/person/{itemId}` to see beneficial owners. By passing `beneficial_accept=1` you confirm the purpose `declaration`. Every lookup is logged with its purpose.", "operationId": "beneficialOwnersPurposes", "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "type": "array", "items": { "properties": { "code": { "type": "string", "example": "B" }, "name": { "type": "string", "example": "Forpligtede enheder (F*)" }, "purposes": { "type": "array", "items": { "properties": { "code": { "type": "string", "example": "F1" }, "name": { "type": "string", "example": "Kreditinstitut (bank mv.)" }, "declaration": { "type": "string", "example": "Jeg erklærer på tro og love, at jeg foretager opslag som Forpligtede enheder (F*) og udelukkende anvender oplysningerne om reelle ejere til det valgte formål (F1 – Kreditinstitut (bank mv.)). Jeg er bekendt med, at urigtige oplysninger eller misbrug – herunder uberettiget videregivelse – kan medføre lukning af adgang og strafansvar." } }, "type": "object" } } }, "type": "object" } } }, "type": "object" } } } } }, "security": [ { "oauth2": [ "companies" ] }, { "oauth2": [ "persons" ] } ] } }, "/company/{cvr}/employees": { "get": { "tags": [ "company" ], "summary": "List a company's number of employees over time", "description": "The employees and full-time equivalents CVR has for the company: monthly from October 2019, quarterly before that, and the older yearly figures, newest first. Where CVR only gives a range, `number` and `fte` are null and `number_range` / `fte_range` carry it.", "operationId": "companyEmployees", "parameters": [ { "name": "cvr", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "$ref": "#/components/schemas/CompanyEmployees" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "companies" ] } ] } }, "/company/{cvr}/changes": { "get": { "tags": [ "company" ], "summary": "List a company's registration history", "description": "The changes registered in CVR for the company, as on its timeline: name, status, address, capital, sector, management, owners, articles of association and mergers. Newest first by default. Annual reports are in `/company/{cvr}?include=financials`.", "operationId": "companyChanges", "parameters": [ { "name": "cvr", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "sort", "in": "query", "schema": { "type": "string", "default": "registered_at", "enum": [ "registered_at" ] } }, { "name": "direction", "in": "query", "schema": { "type": "string", "default": "DESC", "enum": [ "ASC", "DESC" ] } }, { "name": "section", "in": "query", "description": "Comma-separated sections, see `sections`", "schema": { "type": "string" } }, { "name": "year", "in": "query", "description": "Comma-separated years, see `years`", "schema": { "type": "string" } }, { "name": "page", "in": "query", "schema": { "type": "integer", "default": 1 } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1 } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "items": { "type": "array", "items": { "properties": { "registered_at": { "type": "string", "format": "date", "example": "2026-03-26" }, "section": { "description": "One of the values in `sections`, or `registration` (the founding) and `notes`, which are always included", "type": "string", "example": "board_members" }, "title": { "type": "string", "example": "Board member" }, "description": { "type": "string", "example": "Anders Kaae (Suppleant) resigned" }, "name": { "description": "The company's name on that date", "type": "string", "example": "NOVO NORDISK A/S", "nullable": true }, "address": { "description": "The company's address on that date", "type": "string", "nullable": true } }, "type": "object" } }, "sections": { "description": "The sections that have changes, for `section`", "type": "array", "items": { "type": "string" } }, "years": { "description": "The years that have changes, for `year`", "type": "array", "items": { "type": "integer" } }, "count": { "type": "integer", "example": 307 }, "pageCount": { "type": "integer", "example": 16 }, "page": { "type": "integer", "example": 1 }, "nextPageUrl": { "type": "string", "nullable": true }, "prevPageUrl": { "type": "string", "nullable": true } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "companies" ] } ] } }, "/company/{cvr}/p-units": { "get": { "tags": [ "company" ], "summary": "List a company's production units", "operationId": "companyProductionUnits", "parameters": [ { "name": "cvr", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "page", "in": "query", "schema": { "type": "integer", "default": 1 } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 20 } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/ProductionUnit" } }, "count": { "type": "integer", "example": 1 }, "pageCount": { "type": "integer", "example": 1 }, "page": { "type": "integer", "example": 1 }, "nextPageUrl": { "type": "string", "nullable": true }, "prevPageUrl": { "type": "string", "nullable": true } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "companies" ] } ] } }, "/p-unit/{pNumber}": { "get": { "tags": [ "production-unit" ], "summary": "Find production unit by p-number", "operationId": "productionUnitGet", "parameters": [ { "name": "pNumber", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "$ref": "#/components/schemas/ProductionUnit" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "companies" ] } ] } }, "/report/{itemId}": { "get": { "tags": [ "report" ], "summary": "Find report by id", "operationId": "reportGet", "parameters": [ { "name": "itemId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "id": { "type": "integer", "format": "int64", "example": 30491430 }, "slug": { "type": "string", "default": "report" }, "url": { "type": "string", "example": "/api/v2/report/30491430" }, "title": { "type": "string", "example": "2020" }, "start_date": { "type": "string", "format": "date", "example": "2020-01-01" }, "end_date": { "type": "string", "format": "date", "example": "2020-12-31" }, "unit": { "type": "string", "example": "' DKK" }, "income_statement": { "properties": { "Revenue": { "type": "integer", "example": 1378353, "nullable": true }, "CostOfSales": { "type": "integer", "example": 1284832, "nullable": true }, "OtherOperatingIncome": { "type": "integer", "example": 1810, "nullable": true }, "OtherExternalExpenses": { "type": "integer", "example": 30206, "nullable": true }, "GrossProfit": { "type": "integer", "example": 65125, "nullable": true }, "EmployeeBenefitsExpense": { "type": "integer", "example": 38812, "nullable": true }, "Depreciation": { "type": "integer", "example": 6150, "nullable": true }, "OtherOperatingExpenses": { "type": "integer", "example": 55, "nullable": true }, "ProfitLossFromOrdinaryOperatingActivities": { "type": "integer", "example": 20108, "nullable": true }, "IncomeFromInvestmentsInGroupEnterprises": { "type": "integer", "example": 18235, "nullable": true }, "OtherFinanceIncomeFromGroupEnterprises": { "type": "integer", "example": 91, "nullable": true }, "IncomeFromInvestmentsInAssociates": { "type": "integer", "example": 1386, "nullable": true }, "OtherFinanceIncome": { "type": "integer", "example": 6, "nullable": true }, "ImpairmentOfFinancialAssets": { "type": "integer", "example": null, "nullable": true }, "OtherFinanceExpenses": { "type": "integer", "example": 5096, "nullable": true }, "ProfitLossBeforeTax": { "type": "integer", "example": 33526, "nullable": true }, "TaxExpense": { "type": "integer", "example": 3072, "nullable": true }, "ProfitLoss": { "type": "integer", "example": 30454, "nullable": true } }, "type": "object" }, "assets": { "properties": { "Goodwill": { "type": "integer", "example": 0, "nullable": true }, "AcquiredIntangibleAssets": { "type": "integer", "example": null, "nullable": true }, "IntangibleAssets": { "type": "integer", "example": 1109, "nullable": true }, "LandAndBuildings": { "type": "integer", "example": 44244, "nullable": true }, "FixturesFittingsToolsAndEquipment": { "type": "integer", "example": 4766, "nullable": true }, "PropertyPlantAndEquipment": { "type": "integer", "example": 53946, "nullable": true }, "LongtermInvestmentsInGroupEnterprises": { "type": "integer", "example": 130459, "nullable": true }, "LongtermReceivablesFromGroupEnterprises": { "type": "integer", "example": null, "nullable": true }, "LongtermInvestmentsInAssociates": { "type": "integer", "example": 4543, "nullable": true }, "LongtermReceivablesFromAssociates": { "type": "integer", "example": null, "nullable": true }, "OtherLongtermReceivables": { "type": "integer", "example": null, "nullable": true }, "DepositsLongtermInvestmentsAndReceivables": { "type": "integer", "example": null, "nullable": true }, "LongtermInvestmentsAndReceivables": { "type": "integer", "example": 135002, "nullable": true }, "NoncurrentAssets": { "type": "integer", "example": 190057, "nullable": true }, "RawMaterialsAndConsumables": { "type": "integer", "example": null, "nullable": true }, "ManufacturedGoodsAndGoodsForResale": { "type": "integer", "example": 372573, "nullable": true }, "Inventories": { "type": "integer", "example": 392998, "nullable": true }, "ShorttermTradeReceivables": { "type": "integer", "example": 212389, "nullable": true }, "ContractWorkInProgress": { "type": "integer", "example": null, "nullable": true }, "ShorttermReceivablesFromGroupEnterprises": { "type": "integer", "example": 515, "nullable": true }, "CurrentDeferredTaxAssets": { "type": "integer", "example": null, "nullable": true }, "OtherShorttermReceivables": { "type": "integer", "example": 842, "nullable": true }, "ShorttermTaxReceivablesFromGroupEnterprises": { "type": "integer", "example": null, "nullable": true }, "DeferredIncomeAssets": { "type": "integer", "example": 2996, "nullable": true }, "ShorttermReceivables": { "type": "integer", "example": 221544, "nullable": true }, "ShorttermInvestments": { "type": "integer", "example": 65, "nullable": true }, "CashAndCashEquivalents": { "type": "integer", "example": 36, "nullable": true }, "CurrentAssets": { "type": "integer", "example": 614643, "nullable": true }, "Assets": { "type": "integer", "example": 804700, "nullable": true } }, "type": "object" }, "liabilities": { "properties": { "ContributedCapital": { "type": "integer", "example": 1650, "nullable": true }, "RevaluationReserve": { "type": "integer", "example": null, "nullable": true }, "ReserveForNetRevaluationAccordingToEquityMethod": { "type": "integer", "example": 58950, "nullable": true }, "ReserveForDevelopmentExpenditure": { "type": "integer", "example": null, "nullable": true }, "RetainedEarnings": { "type": "integer", "example": 287439, "nullable": true }, "ProposedDividendRecognisedInEquity": { "type": "integer", "example": 13000, "nullable": true }, "Equity": { "type": "integer", "example": 358372, "nullable": true }, "ProvisionsForPensionsAndSimilarLiabilities": { "type": "integer", "example": 0, "nullable": true }, "ProvisionsForDeferredTax": { "type": "integer", "example": 1685, "nullable": true }, "Provisions": { "type": "integer", "example": 1685, "nullable": true }, "LongtermDebtToBanks": { "type": "integer", "example": null, "nullable": true }, "LongtermDebtToCreditInstitutions": { "type": "integer", "example": null, "nullable": true }, "LongtermTaxPayables": { "type": "integer", "example": null, "nullable": true }, "OtherLongtermPayables": { "type": "integer", "example": null, "nullable": true }, "LongtermDeferredIncome": { "type": "integer", "example": null, "nullable": true }, "LongtermLiabilitiesOtherThanProvisions": { "type": "integer", "example": 27888, "nullable": true }, "ShorttermPartOfLongtermLiabilitiesOtherThanProvisions": { "type": "integer", "example": 1656, "nullable": true }, "ShorttermDebtToBanks": { "type": "integer", "example": 245162, "nullable": true }, "ShorttermPrepaymentsReceivedFromCustomers": { "type": "integer", "example": 1200, "nullable": true }, "ShorttermTradePayables": { "type": "integer", "example": 117345, "nullable": true }, "ShorttermPayablesToGroupEnterprises": { "type": "integer", "example": 26034, "nullable": true }, "ShorttermPayablesToAssociates": { "type": "integer", "example": 1243, "nullable": true }, "ShorttermTaxPayables": { "type": "integer", "example": 0, "nullable": true }, "OtherShorttermPayables": { "type": "integer", "example": 24115, "nullable": true }, "ShorttermDeferredIncome": { "type": "integer", "example": null, "nullable": true }, "ShorttermLiabilitiesOtherThanProvisions": { "type": "integer", "example": 416755, "nullable": true }, "LiabilitiesOtherThanProvisions": { "type": "integer", "example": 444643, "nullable": true }, "LiabilitiesAndEquity": { "type": "integer", "example": 804700, "nullable": true } }, "type": "object" } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "companies" ] } ] } }, "/company/{cvr}/follow": { "get": { "tags": [ "company" ], "summary": "State of follow company by cvr", "operationId": "companyFollowGet", "parameters": [ { "name": "cvr", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/CompanySummary" }, "is_followed": { "type": "boolean", "example": true } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "companies" ] } ] }, "post": { "tags": [ "company" ], "summary": "Follow company by cvr", "operationId": "companyFollowPost", "parameters": [ { "name": "cvr", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/CompanySummary" }, "is_followed": { "type": "boolean", "example": true } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "companies" ] } ] }, "delete": { "tags": [ "company" ], "summary": "Unfollow company by cvr", "operationId": "companyFollowDelete", "parameters": [ { "name": "cvr", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/CompanySummary" }, "is_followed": { "type": "boolean", "example": false } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "companies" ] } ] } }, "/company/{cvr}/ajour": { "get": { "tags": [ "company" ], "summary": "State of company to ajour by cvr", "operationId": "companyAjourGet", "parameters": [ { "name": "cvr", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "402": { "$ref": "#/components/responses/AjourPaymentRequired" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/CompanySummary" }, "is_in_ajour": { "type": "boolean", "example": true } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "ajour" ] } ] }, "post": { "tags": [ "company" ], "summary": "Add company to ajour by cvr", "operationId": "companyAjourPost", "parameters": [ { "name": "cvr", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "402": { "$ref": "#/components/responses/AjourPaymentRequired" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/CompanySummary" }, "is_in_ajour": { "type": "boolean", "example": true } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "ajour" ] } ] }, "delete": { "tags": [ "company" ], "summary": "Delete company from ajour by cvr", "operationId": "companyAjourDelete", "parameters": [ { "name": "cvr", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "402": { "$ref": "#/components/responses/AjourPaymentRequired" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/CompanySummary" }, "is_in_ajour": { "type": "boolean", "example": false } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "ajour" ] } ] } }, "/account/followed/companies": { "get": { "tags": [ "account" ], "summary": "List followed companies", "operationId": "accountFollowedCompanies", "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "items": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/CompanySummary" }, "status": { "type": "string", "example": "AKTIV", "nullable": true } }, "type": "object" } }, "count": { "description": "The total number of records in the result set", "type": "integer", "example": 2 }, "page": { "description": "The current page displayed", "type": "integer", "example": 1 }, "pageCount": { "description": "Total number of pages", "type": "integer", "example": 1 }, "nextPageUrl": { "type": "string", "example": null, "nullable": true }, "prevPageUrl": { "type": "string", "example": null, "nullable": true } }, "type": "object" } }, "type": "object" } } } } }, "security": [ { "oauth2": [ "companies" ] } ] } }, "/account/ajour/companies": { "get": { "tags": [ "account" ], "summary": "List ajour companies", "operationId": "accountAjourCompanies", "responses": { "402": { "$ref": "#/components/responses/AjourPaymentRequired" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "items": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/CompanySummary" }, "status": { "type": "string", "example": "AKTIV", "nullable": true } }, "type": "object" } }, "count": { "description": "The total number of records in the result set", "type": "integer", "example": 2 }, "page": { "description": "The current page displayed", "type": "integer", "example": 1 }, "pageCount": { "description": "Total number of pages", "type": "integer", "example": 1 }, "nextPageUrl": { "type": "string", "example": null, "nullable": true }, "prevPageUrl": { "type": "string", "example": null, "nullable": true } }, "type": "object" } }, "type": "object" } } } } }, "security": [ { "oauth2": [ "ajour" ] } ] } }, "/person/search": { "get": { "tags": [ "person" ], "summary": "Search person by name", "operationId": "searchPerson", "parameters": [ { "name": "q", "in": "query", "description": "Person name, 3 to 100 characters", "required": true, "schema": { "type": "string", "maxLength": 100, "minLength": 3 } }, { "name": "page", "in": "query", "description": "Page number. A search has at most 10 pages: past page 10, `items` is empty and only `count` is given", "schema": { "type": "integer", "default": 1 } }, { "name": "limit", "in": "query", "description": "Results per page", "schema": { "type": "integer", "default": 10, "maximum": 10, "minimum": 1 } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "items": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/PersonSummary" }, "company_count": { "type": "integer", "example": 4 }, "relation_count": { "type": "integer", "example": 3 } }, "type": "object" } }, "count": { "description": "The total number of records in the result set", "type": "integer", "example": 1 }, "page": { "description": "The current page displayed", "type": "integer", "example": 1 }, "pageCount": { "description": "Total number of pages", "type": "integer", "example": 1 }, "nextPageUrl": { "type": "string", "example": null, "nullable": true }, "prevPageUrl": { "type": "string", "example": null, "nullable": true } }, "type": "object" } }, "type": "object" } } } }, "400": { "description": "Empty query supplied", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Empty query supplied", "properties": { "status": { "type": "string", "default": "error" }, "error": { "properties": { "code": { "type": "integer", "default": 400 }, "message": { "type": "string", "default": "Empty query supplied" } }, "type": "object" } }, "type": "object" } } } } }, "security": [ { "oauth2": [ "persons" ] } ] } }, "/person/{itemId}": { "get": { "tags": [ "person" ], "summary": "Find person by id", "operationId": "personGet", "parameters": [ { "name": "itemId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "$ref": "#/components/parameters/beneficial_purpose" }, { "$ref": "#/components/parameters/beneficial_accept" } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "id": { "type": "integer", "format": "int64", "example": 4000528644 }, "slug": { "type": "string", "default": "person" }, "url": { "type": "string", "example": "/person/4000528644" }, "name": { "type": "string", "example": "Mick Stjernelykke" }, "address": { "oneOf": [ { "$ref": "#/components/schemas/PropertySummary" } ], "nullable": true }, "owned_companies": { "properties": { "legal": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/CompanySummary" }, "notes": { "type": "string", "example": "33.34-49.99%" } }, "type": "object" } }, "beneficial": { "description": "Requires `beneficial_purpose` and `beneficial_accept=1`. Without them, with an invalid purpose or when beneficial owners are not enabled for your account, the array holds a single notice item with `item.slug` = `beneficial_owners_purposes`, `item.url` pointing to `/beneficial-owners/purposes` and the reason in `notes`, e.g. `To see beneficial owners pass beneficial_purpose and beneficial_accept=1. Allowed purposes: /api/v2/beneficial-owners/purposes` or `Beneficial owners are not enabled for your account.`", "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/CompanySummary" }, "notes": { "type": "string", "example": "33,33%" } }, "type": "object" } }, "ultimate": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/CompanySummary" }, "notes": { "type": "string", "example": "" } }, "type": "object" } } }, "type": "object" }, "roles": { "properties": { "director": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/CompanySummary" }, "notes": { "type": "string", "example": "" } }, "type": "object" } }, "representative": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/CompanySummary" }, "notes": { "type": "string", "example": "" } }, "type": "object" } }, "store_manager": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/CompanySummary" }, "notes": { "type": "string", "example": "" } }, "type": "object" } }, "board_member": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/CompanySummary" }, "notes": { "type": "string", "example": "" } }, "type": "object" } } }, "type": "object" }, "properties": { "description": "Properties this person holds an access/ownership record on. `item.id`/`item.url`/`item.address_1`/`item.address_2` are `null` and named in `item.restricted` when the caller doesn't hold at least a Premium plan. Shown here in full, as if that plan were held.", "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/PropertySummary" }, "notes": { "type": "string", "example": "" } }, "type": "object" } } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "persons" ] } ] } }, "/person/{itemId}/follow": { "get": { "tags": [ "person" ], "summary": "State of follow person by id", "operationId": "personFollowGet", "parameters": [ { "name": "itemId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/PersonSummary" }, "is_followed": { "type": "boolean", "example": true } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "persons" ] } ] }, "post": { "tags": [ "person" ], "summary": "Follow person by id", "operationId": "personFollowPost", "parameters": [ { "name": "itemId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/PersonSummary" }, "is_followed": { "type": "boolean", "example": true } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "persons" ] } ] }, "delete": { "tags": [ "person" ], "summary": "Unfollow person by id", "operationId": "personFollowDelete", "parameters": [ { "name": "itemId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/PersonSummary" }, "is_followed": { "type": "boolean", "example": false } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "persons" ] } ] } }, "/person/{itemId}/ajour": { "get": { "tags": [ "person" ], "summary": "State of person in ajour by id", "operationId": "personAjourGet", "parameters": [ { "name": "itemId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "402": { "$ref": "#/components/responses/AjourPaymentRequired" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/PersonSummary" }, "is_in_ajour": { "type": "boolean", "example": true } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "ajour" ] } ] }, "post": { "tags": [ "person" ], "summary": "Add person to ajour by id", "operationId": "personAjourPost", "parameters": [ { "name": "itemId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "402": { "$ref": "#/components/responses/AjourPaymentRequired" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/PersonSummary" }, "is_in_ajour": { "type": "boolean", "example": true } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "ajour" ] } ] }, "delete": { "tags": [ "person" ], "summary": "Delete person from ajour by id", "operationId": "personAjourDelete", "parameters": [ { "name": "itemId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "402": { "$ref": "#/components/responses/AjourPaymentRequired" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/PersonSummary" }, "is_in_ajour": { "type": "boolean", "example": false } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "ajour" ] } ] } }, "/account/followed/persons": { "get": { "tags": [ "account" ], "summary": "List followed persons", "operationId": "accountFollowedPersons", "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "items": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/PersonSummary" } }, "type": "object" } }, "count": { "description": "The total number of records in the result set", "type": "integer", "example": 1 }, "page": { "description": "The current page displayed", "type": "integer", "example": 1 }, "pageCount": { "description": "Total number of pages", "type": "integer", "example": 1 }, "nextPageUrl": { "type": "string", "example": null, "nullable": true }, "prevPageUrl": { "type": "string", "example": null, "nullable": true } }, "type": "object" } }, "type": "object" } } } } }, "security": [ { "oauth2": [ "persons" ] } ] } }, "/account/ajour/persons": { "get": { "tags": [ "account" ], "summary": "List ajour persons", "operationId": "accountAjourPersons", "responses": { "402": { "$ref": "#/components/responses/AjourPaymentRequired" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "items": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/PersonSummary" } }, "type": "object" } }, "count": { "description": "The total number of records in the result set", "type": "integer", "example": 1 }, "page": { "description": "The current page displayed", "type": "integer", "example": 1 }, "pageCount": { "description": "Total number of pages", "type": "integer", "example": 1 }, "nextPageUrl": { "type": "string", "example": null, "nullable": true }, "prevPageUrl": { "type": "string", "example": null, "nullable": true } }, "type": "object" } }, "type": "object" } } } } }, "security": [ { "oauth2": [ "ajour" ] } ] } }, "/property/search": { "get": { "tags": [ "property" ], "summary": "Search property by address or bfe", "operationId": "searchProperty", "parameters": [ { "name": "q", "in": "query", "description": "Property address or BFE number, 3 to 100 characters", "required": true, "schema": { "type": "string", "maxLength": 100, "minLength": 3 } }, { "name": "page", "in": "query", "description": "Page number. A search has at most 10 pages: past page 10, `items` is empty and only `count` is given", "schema": { "type": "integer", "default": 1 } }, { "name": "limit", "in": "query", "description": "Results per page", "schema": { "type": "integer", "default": 10, "maximum": 10, "minimum": 1 } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "items": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/PropertySummary" }, "type": { "type": "string", "enum": [ "matrikuleret_areal", "ejerlejlighed", "bpfg" ] }, "bfe": { "type": "integer", "example": 2705867, "nullable": true }, "is_parent": { "type": "boolean", "example": false }, "parent_property": { "oneOf": [ { "$ref": "#/components/schemas/PropertySummary" } ], "nullable": true } }, "type": "object" } }, "count": { "description": "The total number of records in the result set", "type": "integer", "example": 1 }, "page": { "description": "The current page displayed", "type": "integer", "example": 1 }, "pageCount": { "description": "Total number of pages", "type": "integer", "example": 1 }, "nextPageUrl": { "type": "string", "example": null, "nullable": true }, "prevPageUrl": { "type": "string", "example": null, "nullable": true } }, "type": "object" } }, "type": "object" } } } }, "400": { "description": "Empty query supplied", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Empty query supplied", "properties": { "status": { "type": "string", "default": "error" }, "error": { "properties": { "code": { "type": "integer", "default": 400 }, "message": { "type": "string", "default": "Empty query supplied" } }, "type": "object" } }, "type": "object" } } } } }, "security": [ { "oauth2": [ "properties" ] } ] } }, "/property/{dafId}": { "get": { "tags": [ "property" ], "summary": "Find property by id", "operationId": "propertyGet", "parameters": [ { "name": "dafId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "id": { "type": "string", "example": "0a3f5088-0f97-32b8-e044-0003ba298018", "nullable": true }, "slug": { "type": "string", "default": "property" }, "url": { "type": "string", "example": "/api/v2/property/0a3f5088-0f97-32b8-e044-0003ba298018", "nullable": true }, "address_1": { "type": "string", "example": "Tybrindvej 10" }, "address_2": { "type": "string", "example": "Husby" }, "zip": { "type": "string", "example": "5592" }, "city": { "type": "string", "example": "Ejby" }, "country": { "type": "string", "example": "DK" }, "bfe": { "type": "integer", "example": 2705867, "nullable": true }, "plot": { "properties": { "cadastral_numbers": { "type": "array", "items": { "type": "string" }, "example": [ "26b" ] }, "road_area": { "type": "integer", "example": 0 }, "registered_area": { "description": "Ground area of the plot (sum of `registreretAreal` of its jordstykker), road area included", "type": "integer", "example": 1538 } }, "type": "object" }, "is_parent": { "type": "boolean", "example": true }, "type": { "type": "string", "example": "matrikuleret_areal" }, "property_category": { "description": "(Premium) `null` and named in `restricted` when the caller doesn't hold at least a Premium plan.", "type": "string", "example": "Enfamiliesejendom", "nullable": true }, "region": { "type": "string", "example": "Syddanmark" }, "district": { "type": "string", "example": "Middelfart" }, "district_code": { "type": "integer", "example": 410 }, "location": { "properties": { "lat": { "type": "number", "example": 55.37178813 }, "lon": { "type": "number", "example": 9.84415165 } }, "type": "object", "nullable": true }, "district_property_id": { "type": "integer", "example": 3202 }, "registered_area": { "description": "Tinglyst areal: the floor area registered in the land registry, set for condominiums (ejerlejligheder) and `null` for most other properties. The ground area of the plot is `plot.registered_area`", "type": "integer", "example": null, "nullable": true }, "ownership_state": { "description": "ejendommensEjerforholdskode: 10 (Privatpersoner eller interessentskab), 20 (Alment boligselskab), 30 (Aktie-, anpart- eller andet selskab (undtagen interessent­skab)), 40 (Forening, legat eller selvejende institution), 41 (Privat andelsboligforening), 50 (Den kommune, hvori ejendommen er beliggende), 60 (Anden primærkommune), 70 (Region), 80 (Staten), 90 (Andet, herunder moderejendomme for bebyggelser, der er opdelt i ejerlejligheder samt ejendomme, der ejes af flere kategorier af ejere), 99 (Ikke beregnet)", "properties": { "code": { "type": "integer", "enum": [ 10, 20, 30, 40, 41, 50, 60, 70, 80, 90, 99 ], "example": 20 }, "text": { "type": "string", "example": "Alment boligselskab" } }, "type": "object", "nullable": true }, "condominium": { "type": "integer", "example": null, "nullable": true }, "condominium_number": { "type": "integer", "example": null, "nullable": true }, "total_building_area": { "description": "Sum of `total_building_area` of the buildings", "type": "integer", "example": 158, "nullable": true }, "residential_building_area": { "description": "Sum of `residential_building_area` of the buildings", "type": "integer", "example": 241, "nullable": true }, "buildings": { "type": "array", "items": { "properties": { "building_number": { "type": "integer", "example": 1 }, "building_usage": { "description": "byg021BygningensAnvendelse: 110 (Stuehus til landbrugsejendom), 120 (Fritliggende enfamiliehus), 121 (Sammenbygget enfamiliehus), 122 (Fritliggende enfamiliehus i tæt-lav bebyggelse), 130 ((UDFASES) Række-, kæde-, eller dobbelthus (lodret adskillelse mellem enhederne).), 131 (Række-, kæde- og klyngehus), 132 (Dobbelthus), 140 (Etagebolig-bygning, flerfamiliehus eller to-familiehus), 150 (Kollegium), 160 (Boligbygning til døgninstitution), 185 (Anneks i tilknytning til helårsbolig.), 190 (Anden bygning til helårsbeboelse), 210 ((UDFASES) Bygning til erhvervsmæssig produktion vedrørende landbrug, gartneri, råstofudvinding o. lign), 211 (Stald til svin), 212 (Stald til kvæg, får mv.), 213 (Stald til fjerkræ), 214 (Minkhal), 215 (Væksthus), 216 (Lade til foder, afgrøder mv.), 217 (Maskinhus, garage mv.), 218 (Lade til halm, hø mv.), 219 (Anden bygning til landbrug mv.), 220 ((UDFASES) Bygning til erhvervsmæssig produktion vedrørende industri, håndværk m.v. (fabrik, værksted o.lign.)), 221 (Bygning til industri med integreret produktionsapparat), 222 (Bygning til industri uden integreret produktionsapparat), 223 (Værksted), 229 (Anden bygning til produktion), 230 ((UDFASES) El-, gas-, vand- eller varmeværk, forbrændingsanstalt m.v.), 231 (Bygning til energiproduktion), 232 (Bygning til forsyning- og energidistribution), 233 (Bygning til vandforsyning), 234 (Bygning til håndtering af affald og spildevand), 239 (Anden bygning til energiproduktion og -distribution), 290 ((UDFASES) Anden bygning til landbrug, industri etc.), 310 ((UDFASES) Transport- og garageanlæg (fragtmandshal, lufthavnsbygning, banegårdsbygning, parkeringshus). Garage med plads til et eller to køretøjer registreres med anvendelseskode 910), 311 (Bygning til jernbane- og busdrift), 312 (Bygning til luftfart), 313 (Bygning til parkering- og transportanlæg), 314 (Bygning til parkering af flere end to køretøjer i tilknytning til boliger), 315 (Havneanlæg), 319 (Andet transportanlæg), 320 ((UDFASES) Bygning til kontor, handel, lager, herunder offentlig administration), 321 (Bygning til kontor), 322 (Bygning til detailhandel), 323 (Bygning til lager), 324 (Butikscenter), 325 (Tankstation), 329 (Anden bygning til kontor, handel og lager), 330 ((UDFASES) Bygning til hotel, restaurant, vaskeri, frisør og anden servicevirksomhed), 331 (Hotel, kro eller konferencecenter med overnatning), 332 (Bed & breakfast mv.), 333 (Restaurant, café og konferencecenter uden overnatning), 334 (Privat servicevirksomhed som frisør, vaskeri, netcafé mv.), 339 (Anden bygning til serviceerhverv), 390 ((UDFASES) Anden bygning til transport, handel etc), 410 ((UDFASES) Bygning til biograf, teater, erhvervsmæssig udstilling, bibliotek, museum, kirke o. lign.), 411 (Biograf, teater, koncertsted mv.), 412 (Museum), 413 (Bibliotek), 414 (Kirke eller anden bygning til trosudøvelse for statsanerkendte trossamfund), 415 (Forsamlingshus), 416 (Forlystelsespark), 419 (Anden bygning til kulturelle formål), 420 ((UDFASES) Bygning til undervisning og forskning (skole, gymnasium, forskningslabratorium o.lign.).), 421 (Grundskole), 422 (Universitet), 429 (Anden bygning til undervisning og forskning), 430 ((UDFASES) Bygning til hospital, sygehjem, fødeklinik o. lign.), 431 (Hospital og sygehus), 432 (Hospice, behandlingshjem mv.), 433 (Sundhedscenter, lægehus, fødeklinik mv.), 439 (Anden bygning til sundhedsformål), 440 ((UDFASES) Bygning til daginstitution), 441 (Daginstitution), 442 (Servicefunktion på døgninstitution), 443 (Kaserne), 444 (Fængsel, arresthus mv.), 449 (Anden bygning til institutionsformål), 451 (Beskyttelsesrum), 490 ((UDFASES) Bygning til anden institution, herunder kaserne, fængsel o. lign.), 510 (Sommerhus), 520 ((UDFASES) Bygning til feriekoloni, vandrehjem o.lign. bortset fra sommerhus), 521 (Feriecenter, center til campingplads mv.), 522 (Bygning med ferielejligheder til erhvervsmæssig udlejning), 523 (Bygning med ferielejligheder til eget brug), 529 (Anden bygning til ferieformål), 530 ((UDFASES) Bygning i forbindelse med idrætsudøvelse (klubhus, idrætshal, svømmehal o. lign.)), 531 (Klubhus i forbindelse med fritid og idræt), 532 (Svømmehal), 533 (Idrætshal), 534 (Tribune i forbindelse med stadion), 535 (Bygning til træning og opstaldning af heste), 539 (Anden bygning til idrætformål), 540 (Kolonihavehus), 585 (Anneks i tilknytning til fritids- og sommerhus), 590 (Anden bygning til fritidsformål), 910 (Garage (med plads til et eller to køretøjer)), 920 (Carport), 930 (Udhus), 940 (Drivhus), 950 (Fritliggende overdækning), 960 (Fritliggende udestue), 970 (Tiloversbleven landbrugsbygning), 990 (Faldefærdig bygning), 999 (Ukendt bygning)", "properties": { "code": { "type": "integer", "enum": [ 110, 120, 121, 122, 130, 131, 132, 140, 150, 160, 185, 190, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 229, 230, 231, 232, 233, 234, 239, 290, 310, 311, 312, 313, 314, 315, 319, 320, 321, 322, 323, 324, 325, 329, 330, 331, 332, 333, 334, 339, 390, 410, 411, 412, 413, 414, 415, 416, 419, 420, 421, 422, 429, 430, 431, 432, 433, 439, 440, 441, 442, 443, 444, 449, 451, 490, 510, 520, 521, 522, 523, 529, 530, 531, 532, 533, 534, 535, 539, 540, 585, 590, 910, 920, 930, 940, 950, 960, 970, 990, 999 ], "example": 314 }, "text": { "type": "string", "example": "Bygning til parkering af flere end to køretøjer i tilknytning til boliger" } }, "type": "object", "nullable": true }, "construction_year": { "type": "integer", "example": 1860 }, "reconstruction_or_extension_year": { "type": "integer", "example": null, "nullable": true }, "water_supply": { "description": "byg030Vandforsyning: 1 (Alment vandforsyningsanlæg), 2 (Privat vandforsyningsanlæg), 3 (Enkeltindvindingsanlæg), 4 (Brønd), 6 (Ikke alment vandforsyningsanlæg), 7 (Blandet vandforsyning), 9 (Ingen vandforsyning)", "properties": { "code": { "type": "integer", "enum": [ 1, 2, 3, 4, 6, 7, 9 ], "example": 7 }, "text": { "type": "string", "example": "Blandet vandforsyning" } }, "type": "object", "nullable": true }, "outer_wall_material": { "description": "byg032YdervæggensMateriale: 1 (Mursten), 2 (Letbetonsten), 3 (Fibercement herunder asbest), 4 (Bindingsværk), 5 (Træ), 6 (Betonelementer), 8 (Metal), 10 (Fibercement uden asbest), 11 (Plastmaterialer), 12 (Glas), 80 (Ingen), 90 (Andet materiale)", "properties": { "code": { "type": "integer", "enum": [ 1, 2, 3, 4, 5, 6, 8, 10, 11, 12, 80, 90 ], "example": 1 }, "text": { "type": "string", "example": "Mursten" } }, "type": "object", "nullable": true }, "roof_cover_material": { "description": "byg033Tagdækningsmateriale: 1 (Tagpap med lille hældning), 2 (Tagpap med stor hældning), 3 (Fibercement herunder asbest), 4 (Betontagsten), 5 (Tegl), 6 (Metal), 7 (Stråtag), 10 (Fibercement uden asbest), 11 (Plastmaterialer), 12 (Glas), 20 (Levende tage), 80 ((UDFASES) Ingen), 90 (Andet materiale)", "properties": { "code": { "type": "integer", "enum": [ 1, 2, 3, 4, 5, 6, 7, 10, 11, 12, 20, 80, 90 ], "example": 5 }, "text": { "type": "string", "example": "Tegl" } }, "type": "object", "nullable": true }, "total_building_area": { "description": "byg038SamletBygningsareal: gross area of the floors, of an attic only the part more than 1.5 m high, basement excluded. It can be smaller than `residential_building_area`, which counts a used attic in full and a basement approved for living", "type": "integer", "example": 158, "nullable": true }, "residential_building_area": { "description": "byg039BygningensSamledeBoligAreal: gross residential area, used attic and basement approved for living included", "type": "integer", "example": 241, "nullable": true }, "business_building_area": { "description": "byg040BygningensSamledeErhvervsAreal: business area", "type": "integer", "example": null, "nullable": true }, "built_area": { "description": "byg041BebyggetAreal: footprint of the building", "type": "integer", "example": 158, "nullable": true }, "area_of_built_in_garage": { "type": "integer", "example": null, "nullable": true }, "area_of_built_in_carport": { "type": "integer", "example": null, "nullable": true }, "number_of_floors": { "type": "integer", "example": 1, "nullable": true }, "heating_installation": { "description": "byg056Varmeinstallation: 1 (Fjernvarme/blokvarme), 2 (Centralvarme med én fyringsenhed), 3 (Ovn til fast og flydende brændsel), 5 (Varmepumpe), 6 (Centralvarme med to fyringsenheder), 7 (Elvarme), 8 (Gasradiator), 9 (Ingen varmeinstallation), 99 (Blandet)", "properties": { "code": { "type": "integer", "enum": [ 1, 2, 3, 5, 6, 7, 8, 9, 99 ], "example": 1 }, "text": { "type": "string", "example": "Fjernvarme/blokvarme" } }, "type": "object", "nullable": true }, "heating_medium": { "description": "byg057Opvarmningsmiddel: 1 (Elektricitet), 2 (Gasværksgas), 3 (Flydende brændsel), 4 (Fast brændsel), 6 (Halm), 7 (Naturgas), 9 (Andet)", "properties": { "code": { "type": "integer", "enum": [ 1, 2, 3, 4, 6, 7, 9 ], "example": 1 }, "text": { "type": "string", "example": "Elektricitet" } }, "type": "object", "nullable": true }, "additional_heating": { "description": "byg058SupplerendeVarme: 0 (Ikke oplyst), 1 (Varmepumpeanlæg), 2 (Ovne til fast eller flydende brændsel), 3 (Ovne til flydende brændsel), 4 (Solpaneler), 5 (Pejs), 6 (Gasradiator), 7 (Elvarme), 10 (Biogasanlæg), 80 (Andet), 90 ((UDFASES) Bygningen har ingen supplerende varme)", "properties": { "code": { "type": "integer", "enum": [ 0, 1, 2, 3, 4, 5, 6, 7, 10, 80, 90 ], "example": 90 }, "text": { "type": "string", "example": "(UDFASES) Bygningen har ingen supplerende varme" } }, "type": "object", "nullable": true }, "protection_status": { "description": "byg070Fredning: 0 (Ingen fredningsstatus), 1 (Bygningen fredet iht. bygningsfredningsloven), 2 (Som 1, men med tinglyste bevaringsbestemmelser jf. lovens §15), 3 (Tinglyst bevaringsdeklaration, men bygningen ikke fredet), 4 (På bygningens middelalderlige bygningsdele er der tinglyst fredningsbestemmelser), 5 (Bygningen indeholder middelalderlige bygningsdele), 6 (Bygningen og dens umiddelbare omgivelser fredet iht. bygningsfredningsloven), 7 (Som 6, men med tinglyst bevaringsdeklaration), 8 (Bygningen bevaringsværdig), 9 (Bygningen medtaget i registrant, bevaringsplan mm.)", "properties": { "code": { "type": "integer", "enum": [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 ], "example": 0 }, "text": { "type": "string", "example": "Ingen fredningsstatus" } }, "type": "object", "nullable": true }, "protection_confirm_url": { "type": "string", "example": null, "nullable": true }, "revision_date": { "type": "string", "format": "date", "example": "2015-01-21" }, "address": { "type": "string", "example": "Tybrindvej 10" }, "technical_installations": { "type": "array", "items": { "$ref": "#/components/schemas/TechnicalInstallation" } }, "unit": { "properties": { "unit_usage": { "description": "enh020EnhedensAnvendelse: 110 (Stuehus til landbrugsejendom), 120 (Fritliggende enfamiliehus), 121 (Sammenbygget enfamiliehus), 122 (Fritliggende enfamiliehus i tæt-lav bebyggelse), 130 ((UDFASES) Række-, kæde- eller dobbelthus (lodret adskillelse mellem enhederne).), 131 (Række-, kæde- og klyngehus), 132 (Dobbelthus), 140 (Bolig i etageejendom, flerfamiliehus eller to-familiehus), 150 (Kollegiebolig), 160 (Bolig i døgninstitution), 185 (Anneks i tilknytning til helårsbolig), 190 (Anden enhed til helårsbeboelse), 210 ((UDFASES) Erhvervsmæssig produktion vedrørende landbrug, skovbrug, gartneri, råstofudvinding og lign.), 211 (Stald til svin), 212 (Stald til kvæg, får mv.), 213 (Stald til fjerkræ), 214 (Minkhal), 215 (Væksthus), 216 (Lade til foder, afgrøder mv.), 217 (Maskinhus, garage mv.), 218 (Lade til halm, hø mv.), 219 (Anden enhed til landbrug mv.), 220 ((UDFASES) Erhvervsmæssig produktion vedrørende industri, håndværk m.v. (fabrik, værksted o. lign.)), 221 (Enhed til industri med integreret produktionsapparat), 222 (Enhed til industri uden integreret produktionsapparat), 223 (Værksted), 229 (Anden enhed til produktion), 230 ((UDFASES) El-, gas-, vand- eller varmeværk, forbrændingsanstalt o. lign.), 231 (Enhed til energiproduktion), 232 (Enhed til forsyning- og energidistribution), 233 (Enhed til vandforsyning), 234 (Enhed til håndtering af affald og spildevand), 239 (Anden enhed til energiproduktion og -distribution), 290 ((UDFASES) Anden enhed til produktion og lager i forbindelse med landbrug, industri o. lign.), 310 ((UDFASES) Transport- og garageanlæg (fragtmandshal, lufthavnsbygning,banegårdsbygning o. lign.)), 311 (Enhed til jernbane- og busdrift), 312 (Enhed til luftfart), 313 (Enhed til parkerings- og transportanlæg), 314 (Enhed til parkering af flere end to køretøjer i tilknytning til boliger), 315 (Havneanlæg), 319 (Andet transportanlæg), 320 ((UDFASES) Engroshandel og lager.), 321 (Enhed til kontor), 322 (Enhed til detailhandel), 323 (Enhed til lager), 324 (Butikscenter), 325 (Tankstation), 329 (Anden enhed til kontor, handel og lager), 330 ((UDFASES) Detailhandel m.v.), 331 (Hotel, kro eller konferencecenter med overnatning), 332 (Bed & breakfast mv.), 333 (Restaurant, café og konferencecenter uden overnatning), 334 (Privat servicevirksomhed som frisør, vaskeri, netcafé mv.), 339 (Anden enhed til serviceerhverv), 340 ((UDFASES) Pengeinstitut, forsikringsvirksomhed m.v.), 350 ((UDFASES) Kontor og liberale erhverv bortset fra offentlig administration (kontorer for advokater, rådgivende ingeniører, klinikker o.lign.)), 360 ((UDFASES) Offentlig administration.), 370 ((UDFASES) Hotel, restauration, vaskeri, frisør og anden servicevirksomhed.), 390 ((UDFASES) Anden enhed til handel, transport etc.), 410 ((UDFASES) Biograf, teater, erhvervsmæssig udstilling m.v.), 411 (Biograf, teater, koncertsted mv.), 412 (Museum), 413 (Bibliotek), 414 (Kirke eller anden enhed til trosudøvelse for statsanerkendte trossamfund), 415 (Forsamlingshus), 416 (Forlystelsespark), 419 (Anden enhed til kulturelle formål), 420 ((UDFASES) Bibliotek, museum, kirke o. lign.), 421 (Grundskole), 422 (Universitet), 429 (Anden enhed til undervisning og forskning), 430 ((UDFASES) Undervisning og forskning (skole, gymnasium, forskningslaboratorium).), 431 (Hospital og sygehus), 432 (Hospice, behandlingshjem mv.), 433 (Sundhedscenter, lægehus, fødeklinik mv.), 439 (Anden enhed til sundhedsformål), 440 ((UDFASES) Hospital, fødeklinik o. lign.), 441 (Daginstitution), 442 (Servicefunktion på døgninstitution), 443 (Kaserne), 444 (Fængsel, arresthus mv.), 449 (Anden enhed til institutionsformål), 450 ((UDFASES) Daginstitution.), 451 (Enhed til beskyttelsesrum), 490 ((UDFASES) Anden institution, herunder kaserne, fængsel m.v.), 510 (Sommerhus.), 520 ((UDFASES) Enhed til feriekoloni, vandrehjem o.lign. bortset fra sommerhus), 521 (Feriecenter, center til campingplads mv.), 522 (Ferielejlighed til erhvervsmæssig udlejning), 523 (Ferielejlighed til eget brug), 529 (Anden enhed til ferieformål), 530 ((UDFASES) Enhed i forbindelse med idrætsudøvelse (klubhus, idrætshal, svømmehal o. lign.).), 531 (Klubhus i forbindelse med fritid- og idræt), 532 (Svømmehal), 533 (Idrætshal), 534 (Tribune i forbindelse med stadion), 535 (Enhed til træning og opstaldning af heste), 539 (Anden enhed til idrætsformål), 540 (Kolonihavehus), 585 (Anneks i tilknytning til fritids- og sommerhus), 590 (Anden enhed til fritidsformål)", "properties": { "code": { "type": "integer", "enum": [ 110, 120, 121, 122, 130, 131, 132, 140, 150, 160, 185, 190, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 229, 230, 231, 232, 233, 234, 239, 290, 310, 311, 312, 313, 314, 315, 319, 320, 321, 322, 323, 324, 325, 329, 330, 331, 332, 333, 334, 339, 340, 350, 360, 370, 390, 410, 411, 412, 413, 414, 415, 416, 419, 420, 421, 422, 429, 430, 431, 432, 433, 439, 440, 441, 442, 443, 444, 449, 450, 451, 490, 510, 520, 521, 522, 523, 529, 530, 531, 532, 533, 534, 535, 539, 540, 585, 590 ], "example": 590 }, "text": { "type": "string", "example": "Anden enhed til fritidsformål" } }, "type": "object", "nullable": true }, "property_type": { "description": "enh023Boligtype: E (Andet), 1 (Egentlig beboelseslejlighed med eget køkken), 2 (Blandet bolig og erhverv med eget køkken), 3 (Enkeltværelse uden eget køkken), 4 (Fællesbolig), 5 (Sommer- eller fritidsbolig)", "properties": { "code": { "type": "string", "enum": [ "E", "1", "2", "3", "4", "5" ], "example": "E" }, "text": { "type": "string", "example": "Andet" } }, "type": "object", "nullable": true }, "condemned_housing": { "description": "enh024KondemneretBoligenhed: 0 (Ikke kondemneret boligenhed), 1 (Kondemneret boligenhed)", "properties": { "code": { "type": "integer", "enum": [ 0, 1 ], "example": 0 }, "text": { "type": "string", "example": "Ikke kondemneret boligenhed" } }, "type": "object", "nullable": true }, "total_area": { "type": "integer", "example": 241 }, "area_for_residence": { "type": "integer", "example": 241, "nullable": true }, "area_for_business": { "type": "integer", "example": null, "nullable": true }, "shared_access_area": { "type": "integer", "example": 11, "nullable": true }, "closed_balcony_area": { "type": "integer", "example": 22, "nullable": true }, "open_balcony_area": { "type": "integer", "example": 12, "nullable": true }, "number_of_rooms": { "type": "integer", "example": 7, "nullable": true }, "kitchen_facilities": { "description": "enh034Køkkenforhold: E (Eget køkken med afløb), F (Adgang til fælles køkken), G (Fast kogeinstallation i værelse eller på gang), H (Ingen fast kogeinstallation)", "properties": { "code": { "type": "string", "enum": [ "E", "F", "G", "H" ], "example": "E" }, "text": { "type": "string", "example": "AEget køkken med afløb" } }, "type": "object", "nullable": true }, "rental_status": { "description": "enh045Udlejningsforhold: 1 (Udlejet), 2 (Benyttet af ejeren), 3 (Ikke benyttet)", "properties": { "code": { "type": "integer", "enum": [ 1, 2, 3 ], "example": 3 }, "text": { "type": "string", "example": "Ikke benyttet" } }, "type": "object", "nullable": true }, "number_of_toilets": { "type": "integer", "example": 2, "nullable": true }, "number_of_bathrooms": { "type": "integer", "example": 1, "nullable": true }, "building_basement_area": { "type": "integer", "example": null, "nullable": true }, "number_of_business_rooms": { "type": "integer", "example": 3, "nullable": true }, "other_area": { "type": "integer", "example": 24, "nullable": true }, "area_source": { "description": "enh030KildeTilEnhedensArealer: 1 (Oplyst af ejer (eller dennes repræsentant)), 2 (Oplyst af teknisk forvaltning), 3 (Oplyst af andre (lukket for indberetning)), 4 (Maskinelt oprettet), 5 (Oplyst og kontrolleret af teknisk forvaltning)", "properties": { "code": { "type": "integer", "enum": [ 1, 2, 3, 4, 5 ], "example": 2 }, "text": { "type": "string", "example": "Oplyst af teknisk forvaltning" } }, "type": "object", "nullable": true }, "toilet_facilities": { "description": "enh032Toiletforhold: A (Vandskyllende toilet uden for enheden), B (Intet vandskyllende toilet), T (Vandskyllende toilet i enheden)", "properties": { "code": { "type": "string", "enum": [ "A", "B", "T" ], "example": "T" }, "text": { "type": "string", "example": "Vandskyllende toilet i enheden" } }, "type": "object", "nullable": true }, "bath_facilities": { "description": "enh033Badeforhold: C (Adgang til badeværelse), D (Hverken badeværelse eller adgang til badeværelse), V (Badeværelse i enheden)", "properties": { "code": { "type": "string", "enum": [ "C", "D", "V" ], "example": "V" }, "text": { "type": "string", "example": "Badeværelse i enheden" } }, "type": "object", "nullable": true }, "energy_supply": { "description": "enh035Energiforsyning: 1 (Gas fra værk), 2 (230 V el fra værk), 3 (400 V el fra værk), 4 (Både 230 V el og gas fra værk), 5 (Både 400 V el og gas fra værk), 6 (Hverken el eller gas fra værk)", "properties": { "code": { "type": "integer", "enum": [ 1, 2, 3, 4, 5, 6 ], "example": 3 }, "text": { "type": "string", "example": "400 V el fra værk" } }, "type": "object", "nullable": true }, "heating_installation": { "description": "enh051Varmeinstallation: 1 (Fjernvarme/blokvarme), 2 (Centralvarme med én fyringsenhed), 3 (Ovn til fast og flydende brændsel), 5 (Varmepumpe), 6 (Centralvarme med to fyringsenheder), 7 (Elvarme), 8 (Gasradiator), 9 (Ingen varmeinstallation), 99 (Blandet)", "properties": { "code": { "type": "integer", "enum": [ 1, 2, 3, 5, 6, 7, 8, 9, 99 ], "example": 1 }, "text": { "type": "string", "example": "Fjernvarme/blokvarme" } }, "type": "object", "nullable": true }, "heating_medium": { "description": "enh052Opvarmningsmiddel: 1 (Elektricitet), 2 (Gasværksgas), 3 (Flydende brændsel), 4 (Fast brændsel), 6 (Halm), 7 (Naturgas), 9 (Andet)", "properties": { "code": { "type": "integer", "enum": [ 1, 2, 3, 4, 6, 7, 9 ], "example": 1 }, "text": { "type": "string", "example": "Elektricitet" } }, "type": "object", "nullable": true }, "additional_heating": { "description": "enh053SupplerendeVarme: 0 (Ikke oplyst), 1 (Varmepumpeanlæg), 2 (Ovne til fast eller flydende brændsel), 3 (Ovne til flydende brændsel), 4 (Solpaneler), 5 (Pejs), 6 (Gasradiator), 7 (Elvarme), 10 (Biogasanlæg), 80 (Andet), 90 ((UDFASES) Bygningen har ingen supplerende varme)", "properties": { "code": { "type": "integer", "enum": [ 0, 1, 2, 3, 4, 5, 6, 7, 10, 80, 90 ], "example": 2 }, "text": { "type": "string", "example": "Ovne til fast eller flydende brændsel" } }, "type": "object", "nullable": true }, "noise_insulation_year": { "type": "integer", "example": 1988, "nullable": true }, "legal_usage": { "description": "enh041LovligAnvendelse: A (Gammelt helårshus eller ikke-personlig disp. til helårsbeboelse), B (Personlig, tidsbegrænset dispensation til helårsbeboelse), C (Personlig, ikke-tidsbegrænset dispensation til helårsbeboelse), D (Personlig, ikke-tidsbegrænset ret til helårsbeboelse for pensionister), E (Dispensation til afvikling af ulovlig helårsbeboelse), I (Ikke relevant for denne enhed)", "properties": { "code": { "type": "string", "enum": [ "A", "B", "C", "D", "E", "I" ], "example": "D" }, "text": { "type": "string", "example": "Personlig, ikke-tidsbegrænset ret til helårsbeboelse for pensionister" } }, "type": "object", "nullable": true }, "public_subsidy": { "description": "enh046OffentligStøtte: 0 (Ingen offentlig støtte), 10 (Almen familiebolig), 15 (Støttet privat udlejningsbolig), 20 (Støttet privat andelsbolig), 25 (Almen ungdomsbolig), 30 (Støttet privat ungdomsbolig), 40 (Almen ældrebolig), 42 (Almen plejebolig), 80 (Serviceareal)", "properties": { "code": { "type": "integer", "enum": [ 0, 10, 15, 20, 25, 30, 40, 42, 80 ], "example": 0 }, "text": { "type": "string", "example": "Ingen offentlig støtte" } }, "type": "object", "nullable": true }, "approved_vacant_housing": { "description": "enh048GodkendtTomBolig: 0 (Krav om persontilmelding), 100 (Bolig uden krav om persontilmelding)", "properties": { "code": { "type": "integer", "enum": [ 0, 100 ], "example": 0 }, "text": { "type": "string", "example": "Krav om persontilmelding" } }, "type": "object", "nullable": true }, "flex_housing_permit_type": { "description": "enh068FlexboligTilladelsesart: 1 (Upersonlig tilladelse uden tidsbegrænsning), 2 (Personlig tilladelse uden tidsbegrænsning), 3 (Upersonlig tilladelse med tidsbegrænsing), 4 (Personlig tilladelse med tidsbegrænsing)", "properties": { "code": { "type": "integer", "enum": [ 1, 2, 3, 4 ], "example": 1 }, "text": { "type": "string", "example": "Upersonlig tilladelse uden tidsbegrænsning" } }, "type": "object", "nullable": true }, "flex_housing_end_date": { "type": "string", "format": "date", "example": null, "nullable": true }, "address_function": { "description": "enh071AdresseFunktion: 0 (Fastsat til denne), 1 (Kun vejledende)", "properties": { "code": { "type": "integer", "enum": [ 0, 1 ], "example": 0 }, "text": { "type": "string", "example": "Fastsat til denne" } }, "type": "object", "nullable": true }, "identification_creation_date": { "type": "string", "format": "date", "example": "2018-03-06", "nullable": true }, "temporary_dispensation_date": { "type": "string", "format": "date", "example": null, "nullable": true }, "partial_occupancy_permit_date": { "type": "string", "format": "date", "example": null, "nullable": true }, "move_in_date": { "type": "string", "format": "date", "example": "2017-12-20", "nullable": true } }, "type": "object" }, "floors": { "type": "array", "items": { "properties": { "building_floor_designation": { "type": "string", "example": "01" }, "total_floor_area": { "type": "integer", "example": 110, "nullable": true }, "area_of_used_part_of_roof_floor": { "type": "integer", "example": 83, "nullable": true }, "basement_area": { "type": "integer", "example": null, "nullable": true }, "legal_residential_area_in_basement": { "type": "string", "example": null, "nullable": true }, "floor_access_area": { "type": "string", "example": null, "nullable": true }, "floor_type": { "description": "eta025Etagetype: 0 (Regulær etage), 1 (Tagetage), 2 (Kælder)", "properties": { "code": { "type": "integer", "enum": [ 0, 1, 2 ], "example": 1 }, "text": { "type": "string", "example": "Tagetage" } }, "type": "object" }, "business_area_in_basement": { "type": "string", "example": null, "nullable": true } }, "type": "object" } }, "stairways": { "type": "array", "items": { "properties": { "has_elevator": { "type": "boolean", "example": false }, "note_lines": { "type": "string", "example": null, "nullable": true } }, "type": "object" } } }, "type": "object" } }, "technical_installations": { "type": "array", "items": { "$ref": "#/components/schemas/TechnicalInstallation" } }, "purchase_amount": { "type": "integer", "example": 1350000, "nullable": true }, "purchase_currency": { "type": "string", "example": "DKK" }, "method_of_transfer": { "type": "string", "example": "Almindelig fri handel" }, "tinglysning_method_of_transfer": { "description": "(Premium) An empty string when tinglysning.dk has none. `null` and named in `restricted` when the caller doesn't hold at least a Premium plan.", "type": "string", "example": "Almindelig fri handel markedsvilkaar", "nullable": true }, "acquisition_date": { "description": "Dato for overtagelse", "type": "string", "format": "date", "example": "2018-02-15", "nullable": true }, "purchase_agreement_date": { "description": "Dato for købsaftale. (Premium) `null` and named in `restricted` when the caller doesn't hold at least a Premium plan.", "type": "string", "format": "date", "example": "2018-01-24", "nullable": true }, "tinglysnings_date": { "description": "Skødedato (deed date). Same Premium-plan masking as `purchase_agreement_date`.", "type": "string", "format": "date", "example": "2018-02-07", "nullable": true }, "access_holders": { "description": "(Premium) `item` is `{id: null, slug, url: null, name: null}` and `access_holders` is named in `restricted` when the caller doesn't hold at least a Premium plan; `ownership_percentage` is kept. Shown here in full, as if that plan were held.", "type": "array", "items": { "properties": { "item": { "oneOf": [ { "$ref": "#/components/schemas/CompanySummary" }, { "$ref": "#/components/schemas/PersonSummary" } ] }, "ownership_percentage": { "type": "string", "example": "100%", "nullable": true } }, "type": "object" } }, "tinglysning": { "oneOf": [ { "$ref": "#/components/schemas/Tinglysning" } ], "nullable": true, "description": "(Premium) Includes the public valuation (`other_information.assessments`). `null` when the property has no BFE or tinglysning.dk holds no data for it, and `null` named in `restricted` when the caller doesn't hold at least a Premium plan. Shown here in full, as if that plan were held." }, "hosted_companies": { "description": "`item` is `{id: null, slug: 'company', url: null, name: null}` and `hosted_companies` is named in `restricted` when the caller doesn't hold at least an Insights All plan. Shown here in full, as if that plan were held.", "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/CompanySummary" } }, "type": "object" } }, "parent_property": { "oneOf": [ { "$ref": "#/components/schemas/PropertySummary" } ], "nullable": true }, "child_properties": { "type": "array", "items": { "$ref": "#/components/schemas/PropertySummary" } }, "restricted": { "description": "Fields your plan does not include; each is `null` above. Present only when something is hidden.", "type": "array", "items": { "type": "string" }, "example": [ "tinglysning", "access_holders" ] } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "properties" ] } ] } }, "/property/{dafId}/follow": { "get": { "tags": [ "property" ], "summary": "State of follow property by dafId", "operationId": "propertyFollowGet", "parameters": [ { "name": "dafId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/PropertySummary" }, "is_followed": { "type": "boolean", "example": true } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "properties" ] } ] }, "post": { "tags": [ "property" ], "summary": "Follow property by dafId", "operationId": "propertyFollowPost", "parameters": [ { "name": "dafId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/PropertySummary" }, "is_followed": { "type": "boolean", "example": true } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "properties" ] } ] }, "delete": { "tags": [ "property" ], "summary": "Unfollow property by dafId", "operationId": "propertyFollowDelete", "parameters": [ { "name": "dafId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/PropertySummary" }, "is_followed": { "type": "boolean", "example": false } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "properties" ] } ] } }, "/property/{dafId}/ajour": { "get": { "tags": [ "property" ], "summary": "State of property in ajour by dafId", "operationId": "propertyAjourGet", "parameters": [ { "name": "dafId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "402": { "$ref": "#/components/responses/AjourPaymentRequired" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/PropertySummary" }, "is_in_ajour": { "type": "boolean", "example": true } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "ajour" ] } ] }, "post": { "tags": [ "property" ], "summary": "Add property to ajour by dafId", "operationId": "propertyAjourPost", "parameters": [ { "name": "dafId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "402": { "$ref": "#/components/responses/AjourPaymentRequired" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/PropertySummary" }, "is_in_ajour": { "type": "boolean", "example": true } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "ajour" ] } ] }, "delete": { "tags": [ "property" ], "summary": "Delete property from ajour by dafId", "operationId": "propertyAjourDelete", "parameters": [ { "name": "dafId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "402": { "$ref": "#/components/responses/AjourPaymentRequired" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/PropertySummary" }, "is_in_ajour": { "type": "boolean", "example": false } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "ajour" ] } ] } }, "/account/followed/properties": { "get": { "tags": [ "account" ], "summary": "List followed properties", "operationId": "accountFollowedProperties", "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "items": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/PropertySummary" }, "bfe": { "type": "integer", "example": 2705867, "nullable": true } }, "type": "object" } }, "count": { "description": "The total number of records in the result set", "type": "integer", "example": 1 }, "page": { "description": "The current page displayed", "type": "integer", "example": 1 }, "pageCount": { "description": "Total number of pages", "type": "integer", "example": 1 }, "nextPageUrl": { "type": "string", "example": null, "nullable": true }, "prevPageUrl": { "type": "string", "example": null, "nullable": true } }, "type": "object" } }, "type": "object" } } } } }, "security": [ { "oauth2": [ "properties" ] } ] } }, "/account/ajour/properties": { "get": { "tags": [ "account" ], "summary": "List ajour properties", "operationId": "accountAjourProperties", "responses": { "402": { "$ref": "#/components/responses/AjourPaymentRequired" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "items": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/PropertySummary" }, "bfe": { "type": "integer", "example": 2705867, "nullable": true } }, "type": "object" } }, "count": { "description": "The total number of records in the result set", "type": "integer", "example": 1 }, "page": { "description": "The current page displayed", "type": "integer", "example": 1 }, "pageCount": { "description": "Total number of pages", "type": "integer", "example": 1 }, "nextPageUrl": { "type": "string", "example": null, "nullable": true }, "prevPageUrl": { "type": "string", "example": null, "nullable": true } }, "type": "object" } }, "type": "object" } } } } }, "security": [ { "oauth2": [ "ajour" ] } ] } }, "/person/segments": { "get": { "tags": [ "segments" ], "summary": "Filter persons by segment criteria", "description": "Preview endpoint — returns only the first 3 matches. Buy the full segment (see the segments/downloads endpoints) to get the complete result set.", "operationId": "segmentPersons", "parameters": [ { "name": "sort", "in": "query", "description": "Sort field", "schema": { "type": "string", "default": "name_normalized", "enum": [ "name_normalized", "birthday", "carrier_started", "zip", "city", "district", "region", "status", "companies_count", "connections_count", "properties_count" ] } }, { "name": "direction", "in": "query", "schema": { "type": "string", "default": "desc", "enum": [ "asc", "desc" ] } }, { "name": "page", "in": "query", "description": "Ignored: the preview always returns the first 3 matches", "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "description": "Ignored: the preview always returns the first 3 matches", "schema": { "type": "integer" } }, { "name": "is_active", "in": "query", "description": "Only active business persons", "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "is_inactive", "in": "query", "description": "Only inactive business persons", "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "is_not_address_protected", "in": "query", "description": "Exclude address-protected persons", "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "has_holding", "in": "query", "description": "Only persons who own a holding company", "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "has_property", "in": "query", "description": "Only persons who own property", "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "regions[]", "in": "query", "description": "Region codes: capital (Region Hovedstaden), central (Region Midtjylland), north (Region Nordjylland), south (Region Syddanmark), zealand (Region Sjælland)", "schema": { "type": "array", "items": { "type": "string", "enum": [ "capital", "central", "north", "south", "zealand" ] } } }, { "name": "districts[]", "in": "query", "description": "Municipality codes", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "cities[]", "in": "query", "description": "City names (postal district)", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "roles[]", "in": "query", "description": "Roles held in companies: director (Direktør), board_member (Bestyrelsesmedlem), owner (Ejer), founder (Stifter), representative (Repræsentant), auditor (Revisor), store_manager (Uddeler), beneficial_owner (Reel ejer)", "schema": { "type": "array", "items": { "type": "string", "enum": [ "director", "board_member", "owner", "founder", "representative", "auditor", "store_manager", "beneficial_owner" ] } } }, { "name": "sectors[]", "in": "query", "description": "CVR sector codes", "schema": { "type": "array", "items": { "type": "integer" } } }, { "name": "company_regions[]", "in": "query", "description": "Cross-filter: the person's company region codes: capital (Region Hovedstaden), central (Region Midtjylland), north (Region Nordjylland), south (Region Syddanmark), zealand (Region Sjælland), greenland (Grønland)", "schema": { "type": "array", "items": { "type": "string", "enum": [ "capital", "central", "north", "south", "zealand", "greenland" ] } } }, { "name": "company_types[]", "in": "query", "description": "Company form codes: 60 (A/S), 80 (ApS), 81 (IVS), 100 (Fund), other", "schema": { "type": "array", "items": { "type": "string", "enum": [ "60", "80", "81", "100", "other" ] } } }, { "name": "zip_from", "in": "query", "description": "Zip code from", "schema": { "type": "integer", "maximum": 9999, "minimum": 1000 } }, { "name": "zip_to", "in": "query", "description": "Zip code to", "schema": { "type": "integer", "maximum": 9999, "minimum": 1000 } }, { "name": "companies_count_from", "in": "query", "description": "Number of companies from", "schema": { "type": "integer", "maximum": 100, "minimum": 1 } }, { "name": "companies_count_to", "in": "query", "description": "Number of companies to", "schema": { "type": "integer", "maximum": 100, "minimum": 1 } }, { "name": "connections_count_from", "in": "query", "description": "Number of connections from", "schema": { "type": "integer", "maximum": 9999, "minimum": 0 } }, { "name": "connections_count_to", "in": "query", "description": "Number of connections to", "schema": { "type": "integer", "maximum": 9999, "minimum": 0 } }, { "name": "carrier_started_from", "in": "query", "description": "Career length from (years)", "schema": { "type": "integer", "maximum": 99, "minimum": 0 } }, { "name": "carrier_started_to", "in": "query", "description": "Career length to (years)", "schema": { "type": "integer", "maximum": 99, "minimum": 0 } }, { "name": "revenue_from", "in": "query", "description": "Revenue from (t.DKK)", "schema": { "type": "integer" } }, { "name": "revenue_to", "in": "query", "description": "Revenue to (t.DKK)", "schema": { "type": "integer" } }, { "name": "profit_before_tax_from", "in": "query", "description": "Profit before tax from (t.DKK)", "schema": { "type": "integer" } }, { "name": "profit_before_tax_to", "in": "query", "description": "Profit before tax to (t.DKK)", "schema": { "type": "integer" } }, { "name": "equity_from", "in": "query", "description": "Equity from (t.DKK)", "schema": { "type": "integer" } }, { "name": "equity_to", "in": "query", "description": "Equity to (t.DKK)", "schema": { "type": "integer" } }, { "name": "holding_equity_from", "in": "query", "description": "Holding equity from (t.DKK)", "schema": { "type": "integer" } }, { "name": "holding_equity_to", "in": "query", "description": "Holding equity to (t.DKK)", "schema": { "type": "integer" } }, { "name": "holding_profit_before_tax_from", "in": "query", "description": "Holding profit before tax from (t.DKK) (Insights all)", "schema": { "type": "integer" } }, { "name": "holding_profit_before_tax_to", "in": "query", "description": "Holding profit before tax to (t.DKK) (Insights all)", "schema": { "type": "integer" } }, { "name": "holding_cash_from", "in": "query", "description": "Holding cash from (t.DKK) (Insights all)", "schema": { "type": "integer" } }, { "name": "holding_cash_to", "in": "query", "description": "Holding cash to (t.DKK) (Insights all)", "schema": { "type": "integer" } }, { "name": "holding_debt_from", "in": "query", "description": "Holding debt from (t.DKK) (Insights all)", "schema": { "type": "integer" } }, { "name": "holding_debt_to", "in": "query", "description": "Holding debt to (t.DKK) (Insights all)", "schema": { "type": "integer" } }, { "name": "holding_age_from", "in": "query", "description": "Holding company age from (years) (Insights all)", "schema": { "type": "integer", "maximum": 99, "minimum": 0 } }, { "name": "holding_age_to", "in": "query", "description": "Holding company age to (years) (Insights all)", "schema": { "type": "integer", "maximum": 99, "minimum": 0 } }, { "name": "age_from", "in": "query", "description": "Person age from (years) (Premium)", "schema": { "type": "integer", "maximum": 99, "minimum": 0 } }, { "name": "age_to", "in": "query", "description": "Person age to (years) (Premium)", "schema": { "type": "integer", "maximum": 99, "minimum": 0 } }, { "name": "properties_count_from", "in": "query", "description": "Number of owned properties from", "schema": { "type": "integer", "maximum": 999, "minimum": 0 } }, { "name": "properties_count_to", "in": "query", "description": "Number of owned properties to", "schema": { "type": "integer", "maximum": 999, "minimum": 0 } }, { "name": "statuses[]", "in": "query", "description": "Company status values — as `status` of companyGet gives them; the former codes without spaces (UNDERKONKURS, Aktiv, …) are still accepted", "schema": { "type": "array", "items": { "type": "string", "enum": [ "AKTIV", "UNDER FRIVILLIG LIKVIDATION", "UNDER REKONSTRUKTION", "UNDER KONKURS", "UNDER TVANGSOPLØSNING", "UNDER REASSUMERING", "UDEN RETSVIRKNING", "OPHØRT", "OPLØST EFTER FRIVILLIG LIKVIDATION", "OPLØST EFTER ERKLÆRING", "TVANGSOPLØST", "OPLØST EFTER FUSION", "OPLØST EFTER SPALTNING", "OPLØST EFTER KONKURS", "SLETTET", "OPLØST", "OPLØST EFTER GRÆNSEOVERSKRIDENDE FUSION", "OPLØST EFTER GRÆNSEOVERSKRIDENDE HJEMSTEDSFLYTNING" ] } } }, { "name": "employees_from", "in": "query", "description": "Number of employees from", "schema": { "type": "integer", "maximum": 99999, "minimum": 0 } }, { "name": "employees_to", "in": "query", "description": "Number of employees to", "schema": { "type": "integer", "maximum": 99999, "minimum": 0 } }, { "name": "founded_from", "in": "query", "description": "Company founded date from", "schema": { "type": "string", "format": "date" } }, { "name": "founded_to", "in": "query", "description": "Company founded date to", "schema": { "type": "string", "format": "date" } }, { "name": "accounted_from", "in": "query", "description": "Latest report date from", "schema": { "type": "string", "format": "date" } }, { "name": "accounted_to", "in": "query", "description": "Latest report date to", "schema": { "type": "string", "format": "date" } }, { "name": "gross_profit_from", "in": "query", "description": "Gross profit from (t.DKK)", "schema": { "type": "integer" } }, { "name": "gross_profit_to", "in": "query", "description": "Gross profit to (t.DKK)", "schema": { "type": "integer" } }, { "name": "cash_from", "in": "query", "description": "Liquid assets from (t.DKK)", "schema": { "type": "integer" } }, { "name": "cash_to", "in": "query", "description": "Liquid assets to (t.DKK)", "schema": { "type": "integer" } }, { "name": "receivables_from", "in": "query", "description": "Receivables from (t.DKK)", "schema": { "type": "integer" } }, { "name": "receivables_to", "in": "query", "description": "Receivables to (t.DKK)", "schema": { "type": "integer" } }, { "name": "employee_benefits_from", "in": "query", "description": "Staff expenses from (t.DKK)", "schema": { "type": "integer" } }, { "name": "employee_benefits_to", "in": "query", "description": "Staff expenses to (t.DKK)", "schema": { "type": "integer" } }, { "name": "liabilities_from", "in": "query", "description": "Debt liabilities from (t.DKK)", "schema": { "type": "integer" } }, { "name": "liabilities_to", "in": "query", "description": "Debt liabilities to (t.DKK)", "schema": { "type": "integer" } }, { "name": "property_types[]", "in": "query", "description": "Property types: matrikuleret_areal (SFE), ejerlejlighed (apartment), bpfg (bygning paa fremmed grund)", "schema": { "type": "array", "items": { "type": "string", "enum": [ "matrikuleret_areal", "ejerlejlighed", "bpfg" ] } } }, { "name": "property_cities[]", "in": "query", "description": "Property city names", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "property_unit_types[]", "in": "query", "description": "BBR property type codes: E (Andet), 1 (Egentlig beboelseslejlighed med eget køkken), 2 (Blandet bolig og erhverv med eget køkken), 3 (Enkeltværelse uden eget køkken), 4 (Fællesbolig), 5 (Sommer- eller fritidsbolig)", "schema": { "type": "array", "items": { "type": "string", "enum": [ "E", "1", "2", "3", "4", "5" ] } } }, { "name": "property_unit_usages[]", "in": "query", "description": "BBR usage codes: 110 (Stuehus til landbrugsejendom), 120 (Fritliggende enfamiliehus), 121 (Sammenbygget enfamiliehus), 122 (Fritliggende enfamiliehus i tæt-lav bebyggelse), 131 (Række-/kæde-/klyngehus), 132 (Dobbelthus), 140 (Bolig i etageejendom/flerfamiliehus), 150 (Kollegiebolig), 160 (Bolig i døgninstitution), 185 (Anneks til helårsbolig), 190 (Anden helårsbeboelse), 211 (Stald til svin), 212 (Stald til kvæg/får), 213 (Stald til fjerkræ), 214 (Minkhal), 215 (Væksthus), 216 (Lade til foder/afgrøder), 217 (Maskinhus/garage), 218 (Lade til halm/hø), 219 (Anden landbrugsenhed), 221 (Industri med integreret produktion), 222 (Industri uden integreret produktion), 223 (Værksted), 229 (Anden produktionsenhed), 231 (Energiproduktion), 232 (Forsyningsdistribution), 233 (Vandforsyning), 234 (Affald og spildevand), 239 (Anden energienhed), 311 (Jernbane- og busdrift), 312 (Luftfart), 313 (Parkerings- og transportanlæg), 314 (Parkering til boliger), 315 (Havneanlæg), 319 (Andet transportanlæg), 321 (Kontor), 322 (Detailhandel), 323 (Lager), 324 (Butikscenter), 325 (Tankstation), 329 (Anden kontor/handel/lager), 331 (Hotel/kro/konferencecenter med overnatning), 332 (Bed & breakfast), 333 (Restaurant/café/konferencecenter), 334 (Privat servicevirksomhed), 339 (Anden serviceenhed), 411 (Biograf/teater/koncertsted), 412 (Museum), 413 (Bibliotek), 414 (Kirke/trosudøvelse), 415 (Forsamlingshus), 416 (Forlystelsespark), 419 (Anden kulturenhed), 421 (Grundskole), 422 (Universitet), 429 (Anden undervisningsenhed), 431 (Hospital og sygehus), 432 (Hospice/behandlingshjem), 433 (Sundhedscenter/lægehus/fødeklinik), 439 (Anden sundhedsenhed), 441 (Daginstitution), 442 (Servicefunktion på døgninstitution), 443 (Kaserne), 444 (Fængsel/arresthus), 449 (Anden institutionsenhed), 451 (Beskyttelsesrum), 510 (Sommerhus), 521 (Feriecenter/campingplads), 522 (Ferielejlighed til erhvervsmæssig udlejning), 523 (Ferielejlighed til eget brug), 529 (Anden ferieenhed), 531 (Klubhus/fritid og idræt), 532 (Svømmehal), 533 (Idrætshal), 534 (Tribune/stadion), 535 (Hesteopstaldning), 539 (Anden idrætsенhed), 540 (Kolonihavehus), 585 (Anneks til fritids-/sommerhus), 590 (Anden fritidsenhed)", "schema": { "type": "array", "items": { "type": "integer", "enum": [ 110, 120, 121, 122, 130, 131, 132, 140, 150, 160, 185, 190, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 229, 230, 231, 232, 233, 234, 239, 290, 310, 311, 312, 313, 314, 315, 319, 320, 321, 322, 323, 324, 325, 329, 330, 331, 332, 333, 334, 339, 340, 350, 360, 370, 390, 410, 411, 412, 413, 414, 415, 416, 419, 420, 421, 422, 429, 430, 431, 432, 433, 439, 440, 441, 442, 443, 444, 449, 450, 451, 490, 510, 520, 521, 522, 523, 529, 530, 531, 532, 533, 534, 535, 539, 540, 585, 590 ] } } }, { "name": "property_zip_from", "in": "query", "description": "Property zip from", "schema": { "type": "integer", "maximum": 9999, "minimum": 1000 } }, { "name": "property_zip_to", "in": "query", "description": "Property zip to", "schema": { "type": "integer", "maximum": 9999, "minimum": 1000 } }, { "name": "property_plot_area_from", "in": "query", "description": "Plot area from (m2)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "property_plot_area_to", "in": "query", "description": "Plot area to (m2)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "property_residence_area_from", "in": "query", "description": "Residence area from (m2)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "property_residence_area_to", "in": "query", "description": "Residence area to (m2)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "property_purchase_price_from", "in": "query", "description": "Purchase price from (usually in DKK)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "property_purchase_price_to", "in": "query", "description": "Purchase price to (usually in DKK)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "property_acquisition_date_from", "in": "query", "description": "Acquisition date from", "schema": { "type": "string", "format": "date" } }, { "name": "property_acquisition_date_to", "in": "query", "description": "Acquisition date to", "schema": { "type": "string", "format": "date" } }, { "name": "property_tinglysnings_date_from", "in": "query", "description": "Deed date from (Premium)", "schema": { "type": "string", "format": "date" } }, { "name": "property_tinglysnings_date_to", "in": "query", "description": "Deed date to (Premium)", "schema": { "type": "string", "format": "date" } }, { "name": "property_loan_update_date_from", "in": "query", "description": "Last endorsement date from (Premium)", "schema": { "type": "string", "format": "date" } }, { "name": "property_loan_update_date_to", "in": "query", "description": "Last endorsement date to (Premium)", "schema": { "type": "string", "format": "date" } }, { "name": "property_regions[]", "in": "query", "description": "Property region codes: capital, central, north, south, zealand", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "property_districts[]", "in": "query", "description": "Property municipality codes", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "property_methods_of_transfer[]", "in": "query", "description": "Property transfer methods: Almindelig fri handel, Anden overdragelse, Familieoverdragelse, Interessesammenfald, Mageskifte, Almindelig fri handel saerlige vilkar", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "property_ownership_states[]", "in": "query", "description": "Property ownership state codes: 10 (Privatpersoner), 20 (Alment boligselskab), 30 (Selskab), 40 (Forening/legat), 41 (Andelsboligforening), 50 (Beliggenhedskommune), 60 (Anden primærkommune), 70 (Region), 80 (Staten), 90 (Andet), 99 (Ikke beregnet)", "schema": { "type": "array", "items": { "type": "integer" } } }, { "name": "property_business_area_from", "in": "query", "description": "Property business area from (m2)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "property_business_area_to", "in": "query", "description": "Property business area to (m2)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "property_rooms_from", "in": "query", "description": "Property number of rooms from", "schema": { "type": "integer", "maximum": 1000, "minimum": 0 } }, { "name": "property_rooms_to", "in": "query", "description": "Property number of rooms to", "schema": { "type": "integer", "maximum": 1000, "minimum": 0 } }, { "name": "property_toilets_from", "in": "query", "description": "Property number of toilets from", "schema": { "type": "integer", "maximum": 1000, "minimum": 0 } }, { "name": "property_toilets_to", "in": "query", "description": "Property number of toilets to", "schema": { "type": "integer", "maximum": 1000, "minimum": 0 } }, { "name": "property_bathrooms_from", "in": "query", "description": "Property number of bathrooms from", "schema": { "type": "integer", "maximum": 1000, "minimum": 0 } }, { "name": "property_bathrooms_to", "in": "query", "description": "Property number of bathrooms to", "schema": { "type": "integer", "maximum": 1000, "minimum": 0 } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "items": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/PersonSummary" }, "is_active": { "type": "boolean", "example": true }, "birthday": { "type": "string", "format": "date", "example": "1975-03-14", "nullable": true }, "companies_count": { "type": "integer", "example": 3 }, "connections_count": { "type": "integer", "example": 12 }, "zip": { "type": "string", "example": "2100" }, "city": { "description": "Locality of the address, empty when the address has none", "type": "string", "example": "Kobenhavn O" }, "postal_district": { "description": "City of the zip code", "type": "string", "example": "København Ø" } }, "type": "object" } }, "count": { "description": "The total number of matches — items is capped to the first 3 regardless of this number", "type": "integer", "example": 142 } }, "type": "object" } }, "type": "object" } } } }, "400": { "description": "No filters supplied, a parameter the endpoint does not document, or a single-value parameter given several values", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "No filters supplied", "properties": { "status": { "type": "string", "default": "error" }, "error": { "properties": { "code": { "type": "integer", "default": 400 }, "message": { "type": "string", "default": "No filters supplied", "example": "Unknown parameters: sector. The parameters of this endpoint are listed in the API specification" } }, "type": "object" } }, "type": "object" } } } } }, "security": [ { "oauth2": [ "persons" ] } ] } }, "/company/segments": { "get": { "tags": [ "segments" ], "summary": "Filter companies by segment criteria", "description": "Preview endpoint — returns only the first 3 matches. Buy the full segment (see the segments/downloads endpoints) to get the complete result set.", "operationId": "segmentCompanies", "parameters": [ { "name": "sort", "in": "query", "description": "Sort field", "schema": { "type": "string", "default": "last_cvr_report.changed", "enum": [ "last_cvr_report.changed", "founded", "employees_number", "ceased", "last_cvr_report.ProfitLossBeforeTax", "last_cvr_report.Equity", "last_cvr_report.GrossProfit", "last_cvr_report.CashAndCashEquivalents", "last_cvr_report.ShorttermReceivables", "last_cvr_report.ShorttermInvestments", "last_cvr_report.EmployeeBenefitsExpense", "last_cvr_report.LiabilitiesOtherThanProvisions", "zip" ] } }, { "name": "direction", "in": "query", "schema": { "type": "string", "default": "desc", "enum": [ "asc", "desc" ] } }, { "name": "page", "in": "query", "description": "Ignored: the preview always returns the first 3 matches", "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "description": "Ignored: the preview always returns the first 3 matches", "schema": { "type": "integer" } }, { "name": "active", "in": "query", "description": "Only active companies", "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "is_inactive", "in": "query", "description": "Only inactive companies", "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "has_contacts", "in": "query", "description": "Only companies with contact info", "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "reports", "in": "query", "description": "Only companies with filed reports", "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "auditor", "in": "query", "description": "Only companies with an auditor", "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "advertising_protected", "in": "query", "description": "Exclude advertising-protected companies", "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "regions[]", "in": "query", "description": "Region codes: capital (Region Hovedstaden), central (Region Midtjylland), north (Region Nordjylland), south (Region Syddanmark), zealand (Region Sjælland), greenland (Grønland, companies with a Greenland address)", "schema": { "type": "array", "items": { "type": "string", "enum": [ "capital", "central", "north", "south", "zealand", "greenland" ] } } }, { "name": "districts[]", "in": "query", "description": "Municipality codes", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "cities[]", "in": "query", "description": "City names (postal district)", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "sectors[]", "in": "query", "description": "CVR sector codes", "schema": { "type": "array", "items": { "type": "integer" } } }, { "name": "types[]", "in": "query", "description": "Company form codes: 10 (ENK/Enkeltmandsvirksomhed), 15 (PMV), 20 (DØD/Dødsbo), 30 (I/S/Interessentskab), 40 (K/S/Kommanditselskab), 45 (MSS), 50 (PAR/Partrederi), 60 (A/S/Aktieselskab), 70 (KAS/Kommanditaktieselskab), 80 (APS/Anpartsselskab), 81 (IVS/Iværksætterselskab), 90 (FON/Fonde), 95 (TRU/Trust), 100 (EFO/Erhvervsdrivende fond), 110 (FOR/Forening), 115 (FFO/Frivillig forening), 130 (ANS/Andelsselskab), 140 (ABA), 150 (FBA), 151 (SMA), 152 (FMA), 160 (EØF), 170 (FAS), 180 (FAP), 190 (FBA), 195 (SCE), 210 (UDL), 220 (FEØ), 230 (STA/Statslig enhed), 235 (SOV), 240 (AMT), 245 (REG/Region), 250 (KOM/Primærkommune), 260 (FKI), 270 (EUO), 280 (ØVR), 285 (FIV), 290 (E/S), 291 (FES), 520 (GUS), 990 (UOP)", "schema": { "type": "array", "items": { "type": "integer", "enum": [ 10, 15, 20, 30, 40, 45, 50, 60, 70, 80, 81, 90, 95, 100, 110, 115, 130, 140, 150, 151, 152, 160, 170, 180, 190, 195, 210, 220, 230, 235, 240, 245, 250, 260, 270, 280, 285, 290, 291, 520, 990 ] } } }, { "name": "statuses[]", "in": "query", "description": "Company status values — as `status` of companyGet gives them; the former codes without spaces (UNDERKONKURS, Aktiv, …) are still accepted", "schema": { "type": "array", "items": { "type": "string", "enum": [ "AKTIV", "UNDER FRIVILLIG LIKVIDATION", "UNDER REKONSTRUKTION", "UNDER KONKURS", "UNDER TVANGSOPLØSNING", "UNDER REASSUMERING", "UDEN RETSVIRKNING", "OPHØRT", "OPLØST EFTER FRIVILLIG LIKVIDATION", "OPLØST EFTER ERKLÆRING", "TVANGSOPLØST", "OPLØST EFTER FUSION", "OPLØST EFTER SPALTNING", "OPLØST EFTER KONKURS", "SLETTET", "OPLØST", "OPLØST EFTER GRÆNSEOVERSKRIDENDE FUSION", "OPLØST EFTER GRÆNSEOVERSKRIDENDE HJEMSTEDSFLYTNING" ] } } }, { "name": "zip_from", "in": "query", "description": "Zip code from", "schema": { "type": "integer", "maximum": 9999, "minimum": 1000 } }, { "name": "zip_to", "in": "query", "description": "Zip code to", "schema": { "type": "integer", "maximum": 9999, "minimum": 1000 } }, { "name": "age_from", "in": "query", "description": "Company age from (years) (Premium)", "schema": { "type": "integer", "maximum": 200, "minimum": 0 } }, { "name": "age_to", "in": "query", "description": "Company age to (years) (Premium)", "schema": { "type": "integer", "maximum": 200, "minimum": 0 } }, { "name": "employees_from", "in": "query", "description": "Number of employees from", "schema": { "type": "integer", "minimum": 0 } }, { "name": "employees_to", "in": "query", "description": "Number of employees to", "schema": { "type": "integer", "minimum": 0 } }, { "name": "founded_from", "in": "query", "description": "Founded date from", "schema": { "type": "string", "format": "date" } }, { "name": "founded_to", "in": "query", "description": "Founded date to", "schema": { "type": "string", "format": "date" } }, { "name": "ceased_from", "in": "query", "description": "Ceased date from", "schema": { "type": "string", "format": "date" } }, { "name": "ceased_to", "in": "query", "description": "Ceased date to", "schema": { "type": "string", "format": "date" } }, { "name": "accounted_from", "in": "query", "description": "Latest report date from", "schema": { "type": "string", "format": "date" } }, { "name": "accounted_to", "in": "query", "description": "Latest report date to", "schema": { "type": "string", "format": "date" } }, { "name": "properties_count_from", "in": "query", "description": "Number of owned properties from (Premium)", "schema": { "type": "integer", "maximum": 999, "minimum": 0 } }, { "name": "properties_count_to", "in": "query", "description": "Number of owned properties to (Premium)", "schema": { "type": "integer", "maximum": 999, "minimum": 0 } }, { "name": "ProfitLossBeforeTax_from", "in": "query", "description": "Profit before tax from (t.DKK)", "schema": { "type": "integer" } }, { "name": "ProfitLossBeforeTax_to", "in": "query", "description": "Profit before tax to (t.DKK)", "schema": { "type": "integer" } }, { "name": "Equity_from", "in": "query", "description": "Equity from (t.DKK)", "schema": { "type": "integer" } }, { "name": "Equity_to", "in": "query", "description": "Equity to (t.DKK)", "schema": { "type": "integer" } }, { "name": "GrossProfit_from", "in": "query", "description": "Gross profit from (t.DKK)", "schema": { "type": "integer" } }, { "name": "GrossProfit_to", "in": "query", "description": "Gross profit to (t.DKK)", "schema": { "type": "integer" } }, { "name": "CashAndCashEquivalents_from", "in": "query", "description": "Liquid assets from (t.DKK)", "schema": { "type": "integer" } }, { "name": "CashAndCashEquivalents_to", "in": "query", "description": "Liquid assets to (t.DKK)", "schema": { "type": "integer" } }, { "name": "ShorttermReceivables_from", "in": "query", "description": "Receivables from (t.DKK)", "schema": { "type": "integer" } }, { "name": "ShorttermReceivables_to", "in": "query", "description": "Receivables to (t.DKK)", "schema": { "type": "integer" } }, { "name": "ShorttermInvestments_from", "in": "query", "description": "Short term investments from (t.DKK)", "schema": { "type": "integer" } }, { "name": "ShorttermInvestments_to", "in": "query", "description": "Short term investments to (t.DKK)", "schema": { "type": "integer" } }, { "name": "EmployeeBenefitsExpense_from", "in": "query", "description": "Staff expenses from (t.DKK)", "schema": { "type": "integer" } }, { "name": "EmployeeBenefitsExpense_to", "in": "query", "description": "Staff expenses to (t.DKK)", "schema": { "type": "integer" } }, { "name": "LiabilitiesOtherThanProvisions_from", "in": "query", "description": "Debt liabilities from (t.DKK)", "schema": { "type": "integer" } }, { "name": "LiabilitiesOtherThanProvisions_to", "in": "query", "description": "Debt liabilities to (t.DKK)", "schema": { "type": "integer" } }, { "name": "property_cities[]", "in": "query", "description": "Property city names", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "property_regions[]", "in": "query", "description": "Property region codes: capital, central, north, south, zealand", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "property_districts[]", "in": "query", "description": "Property municipality codes", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "property_zip_from", "in": "query", "description": "Property zip from", "schema": { "type": "integer", "maximum": 9999, "minimum": 1000 } }, { "name": "property_zip_to", "in": "query", "description": "Property zip to", "schema": { "type": "integer", "maximum": 9999, "minimum": 1000 } }, { "name": "property_unit_types[]", "in": "query", "description": "BBR property type codes: E (Andet), 1 (Egentlig beboelseslejlighed), 2 (Blandet bolig og erhverv), 3 (Enkeltværelse), 4 (Fællesbolig), 5 (Sommer- eller fritidsbolig)", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "property_unit_usages[]", "in": "query", "description": "BBR unit usage codes", "schema": { "type": "array", "items": { "type": "integer" } } }, { "name": "property_methods_of_transfer[]", "in": "query", "description": "Property transfer methods: Almindelig fri handel, Anden overdragelse, Familieoverdragelse, Interessesammenfald, Mageskifte, Almindelig fri handel saerlige vilkar", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "property_ownership_states[]", "in": "query", "description": "Property ownership state codes: 10 (Privatpersoner), 20 (Alment boligselskab), 30 (Selskab), 40 (Forening/legat), 41 (Andelsboligforening), 50 (Beliggenhedskommune), 60 (Anden primærkommune), 70 (Region), 80 (Staten), 90 (Andet), 99 (Ikke beregnet)", "schema": { "type": "array", "items": { "type": "integer" } } }, { "name": "property_purchase_price_from", "in": "query", "description": "Property purchase price from (usually in DKK)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "property_purchase_price_to", "in": "query", "description": "Property purchase price to (usually in DKK)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "property_acquisition_date_from", "in": "query", "description": "Property acquisition date from", "schema": { "type": "string", "format": "date" } }, { "name": "property_acquisition_date_to", "in": "query", "description": "Property acquisition date to", "schema": { "type": "string", "format": "date" } }, { "name": "property_tinglysnings_date_from", "in": "query", "description": "Property deed date from (Premium)", "schema": { "type": "string", "format": "date" } }, { "name": "property_tinglysnings_date_to", "in": "query", "description": "Property deed date to (Premium)", "schema": { "type": "string", "format": "date" } }, { "name": "property_loan_update_date_from", "in": "query", "description": "Property last endorsement date from (Premium)", "schema": { "type": "string", "format": "date" } }, { "name": "property_loan_update_date_to", "in": "query", "description": "Property last endorsement date to (Premium)", "schema": { "type": "string", "format": "date" } }, { "name": "property_plot_area_from", "in": "query", "description": "Property plot area from (m2)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "property_plot_area_to", "in": "query", "description": "Property plot area to (m2)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "property_residence_area_from", "in": "query", "description": "Property residence area from (m2)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "property_residence_area_to", "in": "query", "description": "Property residence area to (m2)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "property_business_area_from", "in": "query", "description": "Property business area from (m2)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "property_business_area_to", "in": "query", "description": "Property business area to (m2)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "property_rooms_from", "in": "query", "description": "Property number of rooms from", "schema": { "type": "integer", "maximum": 1000, "minimum": 0 } }, { "name": "property_rooms_to", "in": "query", "description": "Property number of rooms to", "schema": { "type": "integer", "maximum": 1000, "minimum": 0 } }, { "name": "property_toilets_from", "in": "query", "description": "Property number of toilets from", "schema": { "type": "integer", "maximum": 1000, "minimum": 0 } }, { "name": "property_toilets_to", "in": "query", "description": "Property number of toilets to", "schema": { "type": "integer", "maximum": 1000, "minimum": 0 } }, { "name": "property_bathrooms_from", "in": "query", "description": "Property number of bathrooms from", "schema": { "type": "integer", "maximum": 1000, "minimum": 0 } }, { "name": "property_bathrooms_to", "in": "query", "description": "Property number of bathrooms to", "schema": { "type": "integer", "maximum": 1000, "minimum": 0 } }, { "name": "person_regions[]", "in": "query", "description": "Cross-filter: only companies with a related person from these region codes", "schema": { "type": "array", "items": { "type": "string", "enum": [ "capital", "central", "north", "south", "zealand" ] } } }, { "name": "person_districts[]", "in": "query", "description": "Cross-filter: related person's municipality codes", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "person_cities[]", "in": "query", "description": "Cross-filter: related person's city names", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "person_zip_from", "in": "query", "description": "Cross-filter: related person's zip from", "schema": { "type": "integer", "maximum": 9999, "minimum": 1000 } }, { "name": "person_zip_to", "in": "query", "description": "Cross-filter: related person's zip to", "schema": { "type": "integer", "maximum": 9999, "minimum": 1000 } }, { "name": "person_companies_count_from", "in": "query", "description": "Cross-filter: related person's number of companies from", "schema": { "type": "integer", "minimum": 1 } }, { "name": "person_companies_count_to", "in": "query", "description": "Cross-filter: related person's number of companies to", "schema": { "type": "integer", "minimum": 1 } }, { "name": "person_connections_count_from", "in": "query", "description": "Cross-filter: related person's number of connections from", "schema": { "type": "integer", "minimum": 0 } }, { "name": "person_connections_count_to", "in": "query", "description": "Cross-filter: related person's number of connections to", "schema": { "type": "integer", "minimum": 0 } }, { "name": "person_carrier_started_from", "in": "query", "description": "Cross-filter: related person's career length from (years)", "schema": { "type": "integer", "maximum": 99, "minimum": 0 } }, { "name": "person_carrier_started_to", "in": "query", "description": "Cross-filter: related person's career length to (years)", "schema": { "type": "integer", "maximum": 99, "minimum": 0 } }, { "name": "person_age_from", "in": "query", "description": "Cross-filter: related person's age from (Premium)", "schema": { "type": "integer", "maximum": 99, "minimum": 0 } }, { "name": "person_age_to", "in": "query", "description": "Cross-filter: related person's age to (Premium)", "schema": { "type": "integer", "maximum": 99, "minimum": 0 } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "items": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/CompanySummary" }, "status": { "type": "string", "example": "AKTIV" }, "founded": { "type": "string", "format": "date", "example": "2010-06-15", "nullable": true }, "ceased": { "type": "string", "format": "date", "example": null, "nullable": true }, "employees_number": { "type": "integer", "example": 12, "nullable": true }, "zip": { "type": "string", "example": "1620" }, "city": { "type": "string", "example": "Kobenhavn V" }, "sector": { "properties": { "code": { "type": "integer", "example": 620100 }, "text": { "type": "string", "example": "Udvikling og produktion af software" } }, "type": "object", "nullable": true } }, "type": "object" } }, "count": { "description": "The total number of matches — items is capped to the first 3 regardless of this number", "type": "integer", "example": 842 } }, "type": "object" } }, "type": "object" } } } }, "400": { "description": "No filters supplied, a parameter the endpoint does not document, or a single-value parameter given several values", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "No filters supplied", "properties": { "status": { "type": "string", "default": "error" }, "error": { "properties": { "code": { "type": "integer", "default": 400 }, "message": { "type": "string", "default": "No filters supplied", "example": "Unknown parameters: sector. The parameters of this endpoint are listed in the API specification" } }, "type": "object" } }, "type": "object" } } } } }, "security": [ { "oauth2": [ "companies" ] } ] } }, "/property/segments": { "get": { "tags": [ "segments" ], "summary": "Filter properties by segment criteria", "description": "Preview endpoint — returns only the first 3 matches. Buy the full segment (see the segments/downloads endpoints) to get the complete result set.", "operationId": "segmentProperties", "parameters": [ { "name": "sort", "in": "query", "description": "Sort field", "schema": { "type": "string", "default": "LastPurchase.acquisition_date", "enum": [ "Tinglysning.loan_update_date", "LastPurchase.total_purchase_price", "LastPurchase.acquisition_date", "Tinglysning.purchase_agreement_date", "Tinglysning.tinglysnings_date", "ownership_state_code", "Plot.registered_area", "Unit.area_for_residence", "Unit.area_for_business", "Unit.number_of_rooms", "Unit.number_of_toilets", "Unit.number_of_bathrooms", "zip" ] } }, { "name": "direction", "in": "query", "schema": { "type": "string", "default": "desc", "enum": [ "asc", "desc" ] } }, { "name": "page", "in": "query", "description": "Ignored: the preview always returns the first 3 matches", "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "description": "Ignored: the preview always returns the first 3 matches", "schema": { "type": "integer" } }, { "name": "owner_is_private_person", "in": "query", "description": "Only properties owned by a private person", "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "owner_is_company", "in": "query", "description": "Only properties owned by a company", "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "has_bfe", "in": "query", "description": "Only properties with a BFE number", "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "regions[]", "in": "query", "description": "Region codes: capital (Region Hovedstaden), central (Region Midtjylland), north (Region Nordjylland), south (Region Syddanmark), zealand (Region Sjælland)", "schema": { "type": "array", "items": { "type": "string", "enum": [ "capital", "central", "north", "south", "zealand" ] } } }, { "name": "districts[]", "in": "query", "description": "Municipality codes", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "cities[]", "in": "query", "description": "City names (postal district)", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "types[]", "in": "query", "description": "Property types", "schema": { "type": "array", "items": { "type": "string", "enum": [ "Matrikuleret areal", "Ejerlejlighed", "Bygning pa fremmed grund" ] } } }, { "name": "unit_property_types[]", "in": "query", "description": "BBR property type codes: E (Andet), 1 (Egentlig beboelseslejlighed med eget køkken), 2 (Blandet bolig og erhverv med eget køkken), 3 (Enkeltværelse uden eget køkken), 4 (Fællesbolig), 5 (Sommer- eller fritidsbolig)", "schema": { "type": "array", "items": { "type": "string", "enum": [ "E", "1", "2", "3", "4", "5" ] } } }, { "name": "unit_usages[]", "in": "query", "description": "BBR usage codes: 110 (Stuehus til landbrugsejendom), 120 (Fritliggende enfamiliehus), 121 (Sammenbygget enfamiliehus), 122 (Fritliggende enfamiliehus i tæt-lav bebyggelse), 131 (Række-/kæde-/klyngehus), 132 (Dobbelthus), 140 (Bolig i etageejendom/flerfamiliehus), 150 (Kollegiebolig), 160 (Bolig i døgninstitution), 185 (Anneks til helårsbolig), 190 (Anden helårsbeboelse), 211 (Stald til svin), 212 (Stald til kvæg/får), 213 (Stald til fjerkræ), 214 (Minkhal), 215 (Væksthus), 216 (Lade til foder/afgrøder), 217 (Maskinhus/garage), 218 (Lade til halm/hø), 219 (Anden landbrugsenhed), 221 (Industri med integreret produktion), 222 (Industri uden integreret produktion), 223 (Værksted), 229 (Anden produktionsenhed), 231 (Energiproduktion), 232 (Forsyningsdistribution), 233 (Vandforsyning), 234 (Affald og spildevand), 239 (Anden energienhed), 311 (Jernbane- og busdrift), 312 (Luftfart), 313 (Parkerings- og transportanlæg), 314 (Parkering til boliger), 315 (Havneanlæg), 319 (Andet transportanlæg), 321 (Kontor), 322 (Detailhandel), 323 (Lager), 324 (Butikscenter), 325 (Tankstation), 329 (Anden kontor/handel/lager), 331 (Hotel/kro/konferencecenter med overnatning), 332 (Bed & breakfast), 333 (Restaurant/café/konferencecenter), 334 (Privat servicevirksomhed), 339 (Anden serviceenhed), 411 (Biograf/teater/koncertsted), 412 (Museum), 413 (Bibliotek), 414 (Kirke/trosudøvelse), 415 (Forsamlingshus), 416 (Forlystelsespark), 419 (Anden kulturenhed), 421 (Grundskole), 422 (Universitet), 429 (Anden undervisningsenhed), 431 (Hospital og sygehus), 432 (Hospice/behandlingshjem), 433 (Sundhedscenter/lægehus/fødeklinik), 439 (Anden sundhedsenhed), 441 (Daginstitution), 442 (Servicefunktion på døgninstitution), 443 (Kaserne), 444 (Fængsel/arresthus), 449 (Anden institutionsenhed), 451 (Beskyttelsesrum), 510 (Sommerhus), 521 (Feriecenter/campingplads), 522 (Ferielejlighed til erhvervsmæssig udlejning), 523 (Ferielejlighed til eget brug), 529 (Anden ferieenhed), 531 (Klubhus/fritid og idræt), 532 (Svømmehal), 533 (Idrætshal), 534 (Tribune/stadion), 535 (Hesteopstaldning), 539 (Anden idrætsенhed), 540 (Kolonihavehus), 585 (Anneks til fritids-/sommerhus), 590 (Anden fritidsenhed)", "schema": { "type": "array", "items": { "type": "integer", "enum": [ 110, 120, 121, 122, 130, 131, 132, 140, 150, 160, 185, 190, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 229, 230, 231, 232, 233, 234, 239, 290, 310, 311, 312, 313, 314, 315, 319, 320, 321, 322, 323, 324, 325, 329, 330, 331, 332, 333, 334, 339, 340, 350, 360, 370, 390, 410, 411, 412, 413, 414, 415, 416, 419, 420, 421, 422, 429, 430, 431, 432, 433, 439, 440, 441, 442, 443, 444, 449, 450, 451, 490, 510, 520, 521, 522, 523, 529, 530, 531, 532, 533, 534, 535, 539, 540, 585, 590 ] } } }, { "name": "ownership_states[]", "in": "query", "description": "Ownership state codes: 10 (Privatpersoner eller interessentskab), 20 (Alment boligselskab), 30 (Aktie-/anpart- eller andet selskab), 40 (Forening/legat/selvejende institution), 41 (Privat andelsboligforening), 50 (Beliggenhedskommune), 60 (Anden primærkommune), 70 (Region), 80 (Staten), 90 (Andet), 99 (Ikke beregnet)", "schema": { "type": "array", "items": { "type": "integer", "enum": [ 10, 20, 30, 40, 41, 50, 60, 70, 80, 90, 99 ] } } }, { "name": "technical_installation_classifications[]", "in": "query", "description": "BBR technical installation codes: 1110 (Tank), 1120 (Silo), 1130 (Gasbeholder), 1140 (Affaldsbeholder), 1150 (Udskiller), 1210 (Vindmølle), 1220 (Slanger til jordvarme), 1230 (Solcelleanlæg), 1235 (Solvarmeanlæg), 1240 (Nødstrømsforsyningsanlæg), 1250 (Transformerstation), 1255 (Oliefyr), 1260 (Elskab), 1265 (Naturgasfyr), 1275 (Halmfyr), 1280 (Biogasanlæg), 1285 (Pillefyr), 1290 (Brændeovn), 1295 (Andet energianlæg), 1310 (Vandtårn), 1320 (Pumpestation), 1330 (Swimmingpool), 1340 (Privat rensningsanlæg), 1350 (Offentlige rensningsanlæg), 1360 (Regnvandsanlæg), 1905 (Legeplads), 1910 (Teknikhus), 1915 (Døgnpostboks), 1920 (Køleanlæg), 1925 (Kunstværk), 1930 (Sirene/mast med sirene), 1935 (Skilt), 1940 (Antenne/mast med antenne), 1945 (Dambrug), 1950 (Møddingsanlæg), 1955 (Andet teknisk anlæg), 1960 (Ensilageanlæg), 1965 (Planlager), 1970 (Fortidsminde/historisk ruin)", "schema": { "type": "array", "items": { "type": "integer", "enum": [ 1110, 1120, 1130, 1140, 1150, 1210, 1220, 1230, 1235, 1240, 1250, 1255, 1260, 1265, 1270, 1275, 1280, 1285, 1290, 1295, 1310, 1320, 1330, 1340, 1350, 1360, 1905, 1910, 1915, 1920, 1925, 1930, 1935, 1940, 1945, 1950, 1955, 1960, 1965, 1970 ] } } }, { "name": "methods_of_transfer[]", "in": "query", "description": "Transfer methods", "schema": { "type": "array", "items": { "type": "string", "enum": [ "Almindelig fri handel", "Anden overdragelse", "Familieoverdragelse", "Interessesammenfald", "Mageskifte", "Almindelig fri handel saerlige vilkar" ] } } }, { "name": "zip_from", "in": "query", "description": "Zip from", "schema": { "type": "integer", "maximum": 9999, "minimum": 1000 } }, { "name": "zip_to", "in": "query", "description": "Zip to", "schema": { "type": "integer", "maximum": 9999, "minimum": 1000 } }, { "name": "purchase_amount_from", "in": "query", "description": "Cash purchase amount from (usually in DKK)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "purchase_amount_to", "in": "query", "description": "Cash purchase amount to (usually in DKK)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "property_value_from", "in": "query", "description": "Public property value from (usually in DKK)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "property_value_to", "in": "query", "description": "Public property value to (usually in DKK)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "land_value_from", "in": "query", "description": "Public land value from (usually in DKK)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "land_value_to", "in": "query", "description": "Public land value to (usually in DKK)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "acquisition_date_from", "in": "query", "description": "Acquisition date from", "schema": { "type": "string", "format": "date" } }, { "name": "acquisition_date_to", "in": "query", "description": "Acquisition date to", "schema": { "type": "string", "format": "date" } }, { "name": "purchase_agreement_date_from", "in": "query", "description": "Purchase agreement date from", "schema": { "type": "string", "format": "date" } }, { "name": "purchase_agreement_date_to", "in": "query", "description": "Purchase agreement date to", "schema": { "type": "string", "format": "date" } }, { "name": "tinglysnings_date_from", "in": "query", "description": "Deed date from (Premium)", "schema": { "type": "string", "format": "date" } }, { "name": "tinglysnings_date_to", "in": "query", "description": "Deed date to (Premium)", "schema": { "type": "string", "format": "date" } }, { "name": "loan_update_date_from", "in": "query", "description": "Last endorsement date from (Premium)", "schema": { "type": "string", "format": "date" } }, { "name": "loan_update_date_to", "in": "query", "description": "Last endorsement date to (Premium)", "schema": { "type": "string", "format": "date" } }, { "name": "plot_registered_area_from", "in": "query", "description": "Plot area from (m2)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "plot_registered_area_to", "in": "query", "description": "Plot area to (m2)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "unit_area_for_residence_from", "in": "query", "description": "Residence area from (m2)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "unit_area_for_residence_to", "in": "query", "description": "Residence area to (m2)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "unit_area_for_business_from", "in": "query", "description": "Business area from (m2)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "unit_area_for_business_to", "in": "query", "description": "Business area to (m2)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "number_of_rooms_from", "in": "query", "description": "Number of rooms from", "schema": { "type": "integer", "maximum": 1000, "minimum": 0 } }, { "name": "number_of_rooms_to", "in": "query", "description": "Number of rooms to", "schema": { "type": "integer", "maximum": 1000, "minimum": 0 } }, { "name": "number_of_toilets_from", "in": "query", "description": "Number of toilets from", "schema": { "type": "integer", "maximum": 1000, "minimum": 0 } }, { "name": "number_of_toilets_to", "in": "query", "description": "Number of toilets to", "schema": { "type": "integer", "maximum": 1000, "minimum": 0 } }, { "name": "number_of_bathrooms_from", "in": "query", "description": "Number of bathrooms from", "schema": { "type": "integer", "maximum": 1000, "minimum": 0 } }, { "name": "number_of_bathrooms_to", "in": "query", "description": "Number of bathrooms to", "schema": { "type": "integer", "maximum": 1000, "minimum": 0 } }, { "name": "technical_installation_year_from", "in": "query", "description": "Technical installation's establishment year from (Premium)", "schema": { "type": "integer", "maximum": 2100, "minimum": 1800 } }, { "name": "technical_installation_year_to", "in": "query", "description": "Technical installation's establishment year to (Premium)", "schema": { "type": "integer", "maximum": 2100, "minimum": 1800 } }, { "name": "technical_installation_decommission_year_from", "in": "query", "description": "Technical installation's decommission year from (Premium)", "schema": { "type": "integer", "maximum": 2100, "minimum": 1800 } }, { "name": "technical_installation_decommission_year_to", "in": "query", "description": "Technical installation's decommission year to (Premium)", "schema": { "type": "integer", "maximum": 2100, "minimum": 1800 } }, { "name": "technical_installation_reconstruction_year_from", "in": "query", "description": "Technical installation's reconstruction/extension year from (Premium)", "schema": { "type": "integer", "maximum": 2100, "minimum": 1800 } }, { "name": "technical_installation_reconstruction_year_to", "in": "query", "description": "Technical installation's reconstruction/extension year to (Premium)", "schema": { "type": "integer", "maximum": 2100, "minimum": 1800 } }, { "name": "technical_installation_size_from", "in": "query", "description": "Technical installation's size from (liter) (Premium)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "technical_installation_size_to", "in": "query", "description": "Technical installation's size to (liter) (Premium)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "technical_installation_volume_from", "in": "query", "description": "Technical installation's volume from (m3) (Premium)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "technical_installation_volume_to", "in": "query", "description": "Technical installation's volume to (m3) (Premium)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "technical_installation_area_from", "in": "query", "description": "Technical installation's area from (m2) (Premium)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "technical_installation_area_to", "in": "query", "description": "Technical installation's area to (m2) (Premium)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "technical_installation_height_from", "in": "query", "description": "Technical installation's height from (meter) (Premium)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "technical_installation_height_to", "in": "query", "description": "Technical installation's height to (meter) (Premium)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "technical_installation_power_from", "in": "query", "description": "Technical installation's power from (kilowatt) (Premium)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "technical_installation_power_to", "in": "query", "description": "Technical installation's power to (kilowatt) (Premium)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "technical_installation_hub_height_from", "in": "query", "description": "Wind turbine hub height from (meter) (Premium)", "schema": { "type": "number", "minimum": 0 } }, { "name": "technical_installation_hub_height_to", "in": "query", "description": "Wind turbine hub height to (meter) (Premium)", "schema": { "type": "number", "minimum": 0 } }, { "name": "technical_installation_rotor_diameter_from", "in": "query", "description": "Wind turbine rotor diameter from (meter) (Premium)", "schema": { "type": "number", "minimum": 0 } }, { "name": "technical_installation_rotor_diameter_to", "in": "query", "description": "Wind turbine rotor diameter to (meter) (Premium)", "schema": { "type": "number", "minimum": 0 } }, { "name": "technical_installation_revision_date_from", "in": "query", "description": "Technical installation's revision date from (Premium)", "schema": { "type": "string", "format": "date" } }, { "name": "technical_installation_revision_date_to", "in": "query", "description": "Technical installation's revision date to (Premium)", "schema": { "type": "string", "format": "date" } }, { "name": "technical_installation_last_inspection_date_from", "in": "query", "description": "Technical installation's last inspection date from (Premium)", "schema": { "type": "string", "format": "date" } }, { "name": "technical_installation_last_inspection_date_to", "in": "query", "description": "Technical installation's last inspection date to (Premium)", "schema": { "type": "string", "format": "date" } }, { "name": "technical_installation_validity_date_from", "in": "query", "description": "Technical installation's validity date from (Premium)", "schema": { "type": "string", "format": "date" } }, { "name": "technical_installation_validity_date_to", "in": "query", "description": "Technical installation's validity date to (Premium)", "schema": { "type": "string", "format": "date" } }, { "name": "technical_installation_statuses[]", "in": "query", "description": "Technical installation lifecycle codes (Livscyklus) (Premium): 1 (Start), 2 (Projekteret), 3 (Under opførsel), 4 (Sagsgrund), 5 (Oprettet), 6 (Opført), 7 (Gældende), 8 (Godkendt), 9 (Afsluttet), 10 (Historisk), 11 (Fejlregistreret), 12 (Midlertidig Afsluttet), 13 (Delvis Afsluttet), 14 (Henlagt), 15 (Modtaget), 16 (UnderBehandling), 17 (Fejl), 18 (Udført), 19 (Foreløbig)", "schema": { "type": "array", "items": { "type": "integer", "enum": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19 ] } } }, { "name": "technical_installation_size_classes[]", "in": "query", "description": "Oil tank size class codes (Premium): 1 (Under 6.000 l), 2 (6.000 l - 100.000 l), 3 (Over 100.000 l)", "schema": { "type": "array", "items": { "type": "integer", "enum": [ 1, 2, 3 ] } } }, { "name": "technical_installation_placements[]", "in": "query", "description": "Placement codes (Premium): 0 (Ukendt), 1 (Nedgravet), 2 (Over terræn, udendørs), 3 (Indendørs)", "schema": { "type": "array", "items": { "type": "integer", "enum": [ 0, 1, 2, 3 ] } } }, { "name": "technical_installation_decommission_types[]", "in": "query", "description": "Oil tank decommission codes (Premium): 1 (Tanken er afblændet), 2 (Tanken er tømt og afblændet), 3 (Tanken er tømt, afblændet og opfyldt), 4 (Tanken er tømt, afblændet og påfyldningsstuds samt udluftningsrør afmonteret), 10 (Jordvarmeslangerne er sløjfet/taget ud af drift)", "schema": { "type": "array", "items": { "type": "integer", "enum": [ 1, 2, 3, 4, 10 ] } } }, { "name": "technical_installation_oil_tank_contents[]", "in": "query", "description": "Oil tank content codes (Premium): 10 (Mineralske olieprodukter), 11 (Fuelolie), 12 (Fyringsgasolie), 13 (Autogasolie/Dieselolie), 14 (Benzin), 20 (Biobrændstoffer), 30 (Affaldsprodukter), 31 (Oliebaserede affaldsprodukter/Spildolie), 40 (Gylle), 50 (Ajle/ensilagesaft/mælkerumsvand/møddingvand), 60 (Øvrige forurenende stoffer), 70 (Korn), 99 (Andet)", "schema": { "type": "array", "items": { "type": "integer", "enum": [ 10, 11, 12, 13, 14, 20, 30, 31, 40, 50, 60, 70, 99 ] } } }, { "name": "technical_installation_operation_statuses[]", "in": "query", "description": "Operational status codes (Driftstatus) (Premium): 1 (I drift), 2 (Ikke i drift)", "schema": { "type": "array", "items": { "type": "integer", "enum": [ 1, 2 ] } } }, { "name": "technical_installation_materials[]", "in": "query", "description": "Material codes (Materiale) (Premium): 1 (Plast), 2 (Stål), 3 (Plasttank med udvendig stålvæg)", "schema": { "type": "array", "items": { "type": "integer", "enum": [ 1, 2, 3 ] } } }, { "name": "technical_installation_fabrication_type", "in": "query", "description": "Technical installation's manufacturer/model (Fabrikat type) (Premium)", "schema": { "type": "string", "maxLength": 256 } }, { "name": "technical_installation_fabrication_number", "in": "query", "description": "Technical installation's manufacturing/serial number (Fabrikationsnummer) (Premium)", "schema": { "type": "string", "maxLength": 256 } }, { "name": "technical_installation_type_approval_number_from", "in": "query", "description": "Technical installation's type approval number from (Typegodkendelsesnummer) (Premium)", "schema": { "type": "string", "maxLength": 256 } }, { "name": "technical_installation_type_approval_number_to", "in": "query", "description": "Technical installation's type approval number to (Typegodkendelsesnummer) (Premium)", "schema": { "type": "string", "maxLength": 256 } }, { "name": "technical_installation_wind_turbine_number_from", "in": "query", "description": "Wind turbine number from (Vindmøllenummer) (Premium)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "technical_installation_wind_turbine_number_to", "in": "query", "description": "Wind turbine number to (Vindmøllenummer) (Premium)", "schema": { "type": "integer", "minimum": 0 } }, { "name": "technical_installation_inspecting_company", "in": "query", "description": "Company that inspected the technical installation (Inspicerende virksomhed) (Premium)", "schema": { "type": "string", "maxLength": 256 } }, { "name": "owner_person_regions[]", "in": "query", "description": "Cross-filter: only properties with a private-person owner from these region codes", "schema": { "type": "array", "items": { "type": "string", "enum": [ "capital", "central", "north", "south", "zealand" ] } } }, { "name": "owner_person_districts[]", "in": "query", "description": "Cross-filter: only properties with a private-person owner from these municipality codes", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "owner_person_cities[]", "in": "query", "description": "Cross-filter: only properties with a private-person owner from these city names (postal district)", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "owner_person_zip_from", "in": "query", "description": "Cross-filter: owner's zip from", "schema": { "type": "integer", "maximum": 9999, "minimum": 1000 } }, { "name": "owner_person_zip_to", "in": "query", "description": "Cross-filter: owner's zip to", "schema": { "type": "integer", "maximum": 9999, "minimum": 1000 } }, { "name": "owner_person_companies_count_from", "in": "query", "description": "Cross-filter: owner's number of companies from", "schema": { "type": "integer", "minimum": 1 } }, { "name": "owner_person_companies_count_to", "in": "query", "description": "Cross-filter: owner's number of companies to", "schema": { "type": "integer", "minimum": 1 } }, { "name": "owner_person_connections_count_from", "in": "query", "description": "Cross-filter: owner's number of connections from", "schema": { "type": "integer", "minimum": 0 } }, { "name": "owner_person_connections_count_to", "in": "query", "description": "Cross-filter: owner's number of connections to", "schema": { "type": "integer", "minimum": 0 } }, { "name": "owner_person_carrier_started_from", "in": "query", "description": "Cross-filter: owner's career length (years) from", "schema": { "type": "integer", "maximum": 99, "minimum": 0 } }, { "name": "owner_person_carrier_started_to", "in": "query", "description": "Cross-filter: owner's career length (years) to", "schema": { "type": "integer", "maximum": 99, "minimum": 0 } }, { "name": "owner_person_age_from", "in": "query", "description": "Cross-filter: owner's age from (Premium)", "schema": { "type": "integer", "maximum": 99, "minimum": 0 } }, { "name": "owner_person_age_to", "in": "query", "description": "Cross-filter: owner's age to (Premium)", "schema": { "type": "integer", "maximum": 99, "minimum": 0 } }, { "name": "company_regions[]", "in": "query", "description": "Cross-filter: owner company's region codes: capital (Region Hovedstaden), central (Region Midtjylland), north (Region Nordjylland), south (Region Syddanmark), zealand (Region Sjælland), greenland (Grønland)", "schema": { "type": "array", "items": { "type": "string", "enum": [ "capital", "central", "north", "south", "zealand", "greenland" ] } } }, { "name": "sectors[]", "in": "query", "description": "Cross-filter: owner company's CVR sector codes", "schema": { "type": "array", "items": { "type": "integer" } } }, { "name": "company_types[]", "in": "query", "description": "Cross-filter: owner company's form codes: 60 (A/S), 80 (ApS), 81 (IVS), 100 (Fund), other", "schema": { "type": "array", "items": { "type": "string", "enum": [ "60", "80", "81", "100", "other" ] } } }, { "name": "statuses[]", "in": "query", "description": "Cross-filter: owner company's status values — as `status` of companyGet gives them; the former codes without spaces (UNDERKONKURS, Aktiv, …) are still accepted", "schema": { "type": "array", "items": { "type": "string", "enum": [ "AKTIV", "UNDER FRIVILLIG LIKVIDATION", "UNDER REKONSTRUKTION", "UNDER KONKURS", "UNDER TVANGSOPLØSNING", "UNDER REASSUMERING", "UDEN RETSVIRKNING", "OPHØRT", "OPLØST EFTER FRIVILLIG LIKVIDATION", "OPLØST EFTER ERKLÆRING", "TVANGSOPLØST", "OPLØST EFTER FUSION", "OPLØST EFTER SPALTNING", "OPLØST EFTER KONKURS", "SLETTET", "OPLØST", "OPLØST EFTER GRÆNSEOVERSKRIDENDE FUSION", "OPLØST EFTER GRÆNSEOVERSKRIDENDE HJEMSTEDSFLYTNING" ] } } }, { "name": "employees_from", "in": "query", "description": "Cross-filter: owner company's number of employees from", "schema": { "type": "integer", "maximum": 99999, "minimum": 0 } }, { "name": "employees_to", "in": "query", "description": "Cross-filter: owner company's number of employees to", "schema": { "type": "integer", "maximum": 99999, "minimum": 0 } }, { "name": "founded_from", "in": "query", "description": "Cross-filter: owner company's founded date from", "schema": { "type": "string", "format": "date" } }, { "name": "founded_to", "in": "query", "description": "Cross-filter: owner company's founded date to", "schema": { "type": "string", "format": "date" } }, { "name": "accounted_from", "in": "query", "description": "Cross-filter: owner company's latest report date from", "schema": { "type": "string", "format": "date" } }, { "name": "accounted_to", "in": "query", "description": "Cross-filter: owner company's latest report date to", "schema": { "type": "string", "format": "date" } }, { "name": "revenue_from", "in": "query", "description": "Cross-filter: owner company's revenue from (t.DKK)", "schema": { "type": "integer" } }, { "name": "revenue_to", "in": "query", "description": "Cross-filter: owner company's revenue to (t.DKK)", "schema": { "type": "integer" } }, { "name": "profit_before_tax_from", "in": "query", "description": "Cross-filter: owner company's profit before tax from (t.DKK)", "schema": { "type": "integer" } }, { "name": "profit_before_tax_to", "in": "query", "description": "Cross-filter: owner company's profit before tax to (t.DKK)", "schema": { "type": "integer" } }, { "name": "equity_from", "in": "query", "description": "Cross-filter: owner company's equity from (t.DKK)", "schema": { "type": "integer" } }, { "name": "equity_to", "in": "query", "description": "Cross-filter: owner company's equity to (t.DKK)", "schema": { "type": "integer" } }, { "name": "gross_profit_from", "in": "query", "description": "Cross-filter: owner company's gross profit from (t.DKK)", "schema": { "type": "integer" } }, { "name": "gross_profit_to", "in": "query", "description": "Cross-filter: owner company's gross profit to (t.DKK)", "schema": { "type": "integer" } }, { "name": "cash_from", "in": "query", "description": "Cross-filter: owner company's liquid assets from (t.DKK)", "schema": { "type": "integer" } }, { "name": "cash_to", "in": "query", "description": "Cross-filter: owner company's liquid assets to (t.DKK)", "schema": { "type": "integer" } }, { "name": "receivables_from", "in": "query", "description": "Cross-filter: owner company's receivables from (t.DKK)", "schema": { "type": "integer" } }, { "name": "receivables_to", "in": "query", "description": "Cross-filter: owner company's receivables to (t.DKK)", "schema": { "type": "integer" } }, { "name": "employee_benefits_from", "in": "query", "description": "Cross-filter: owner company's staff expenses from (t.DKK)", "schema": { "type": "integer" } }, { "name": "employee_benefits_to", "in": "query", "description": "Cross-filter: owner company's staff expenses to (t.DKK)", "schema": { "type": "integer" } }, { "name": "liabilities_from", "in": "query", "description": "Cross-filter: owner company's debt liabilities from (t.DKK)", "schema": { "type": "integer" } }, { "name": "liabilities_to", "in": "query", "description": "Cross-filter: owner company's debt liabilities to (t.DKK)", "schema": { "type": "integer" } }, { "name": "holding_equity_from", "in": "query", "description": "Cross-filter: owner company's holding equity from (t.DKK)", "schema": { "type": "integer" } }, { "name": "holding_equity_to", "in": "query", "description": "Cross-filter: owner company's holding equity to (t.DKK)", "schema": { "type": "integer" } }, { "name": "holding_profit_before_tax_from", "in": "query", "description": "Cross-filter: owner company's holding profit before tax from (t.DKK) (Insights all)", "schema": { "type": "integer" } }, { "name": "holding_profit_before_tax_to", "in": "query", "description": "Cross-filter: owner company's holding profit before tax to (t.DKK) (Insights all)", "schema": { "type": "integer" } }, { "name": "holding_cash_from", "in": "query", "description": "Cross-filter: owner company's holding cash from (t.DKK) (Insights all)", "schema": { "type": "integer" } }, { "name": "holding_cash_to", "in": "query", "description": "Cross-filter: owner company's holding cash to (t.DKK) (Insights all)", "schema": { "type": "integer" } }, { "name": "holding_debt_from", "in": "query", "description": "Cross-filter: owner company's holding debt from (t.DKK) (Insights all)", "schema": { "type": "integer" } }, { "name": "holding_debt_to", "in": "query", "description": "Cross-filter: owner company's holding debt to (t.DKK) (Insights all)", "schema": { "type": "integer" } }, { "name": "holding_age_from", "in": "query", "description": "Cross-filter: owner company's holding company age from (years) (Insights all)", "schema": { "type": "integer", "maximum": 99, "minimum": 0 } }, { "name": "holding_age_to", "in": "query", "description": "Cross-filter: owner company's holding company age to (years) (Insights all)", "schema": { "type": "integer", "maximum": 99, "minimum": 0 } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "items": { "type": "array", "items": { "properties": { "item": { "$ref": "#/components/schemas/PropertySummary" }, "bfe": { "type": "integer", "example": 3841207, "nullable": true }, "acquisition_date": { "type": "string", "format": "date", "example": "2018-04-01", "nullable": true }, "purchase_amount": { "description": "Cash purchase amount (usually in DKK)", "type": "integer", "example": 3250000, "nullable": true }, "plot_area": { "description": "Plot area (m2)", "type": "integer", "example": 820, "nullable": true }, "residence_area": { "description": "Residence area (m2)", "type": "integer", "example": 148, "nullable": true } }, "type": "object" } }, "count": { "description": "The total number of matches — items is capped to the first 3 regardless of this number", "type": "integer", "example": 318 } }, "type": "object" } }, "type": "object" } } } }, "400": { "description": "No filters supplied, a parameter the endpoint does not document, or a single-value parameter given several values", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "No filters supplied", "properties": { "status": { "type": "string", "default": "error" }, "error": { "properties": { "code": { "type": "integer", "default": 400 }, "message": { "type": "string", "default": "No filters supplied", "example": "Unknown parameters: sector. The parameters of this endpoint are listed in the API specification" } }, "type": "object" } }, "type": "object" } } } } }, "security": [ { "oauth2": [ "properties" ] } ] } }, "/segments/downloads": { "get": { "tags": [ "segments" ], "summary": "List purchased segments", "description": "Lists the account's purchased segment downloads (see the person/company/property segments endpoints to find and buy one). Use segments/downloads/{id} to read one in full.", "operationId": "segmentsDownloads", "parameters": [ { "name": "page", "in": "query", "description": "Page number", "schema": { "type": "integer", "default": 1 } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "items": { "type": "array", "items": { "properties": { "id": { "type": "integer", "example": 42 }, "type": { "type": "string", "enum": [ "company", "person", "property" ], "example": "property" }, "title": { "type": "string", "example": "Segment d. 12.03.2026 14:20:00" }, "size": { "description": "Number of entities matching the filters now. A watched segment keeps the rows of entities that left it, with `afgangsdato` set, so the rows of the download can outnumber it", "type": "integer", "example": 318 }, "is_paid": { "type": "boolean", "example": true }, "is_watched": { "description": "Whether the segment is a monitored subscription that keeps adding new matches", "type": "boolean", "example": false }, "created": { "type": "string", "format": "date-time" }, "expires": { "description": "Until when the rows can be read, after that `GET /segments/downloads/{id}` answers 404 and the download is deleted. An unpaid download expires 30 days after it was made; a paid one 3 years after it was paid, or, when it was monitored, 3 years after its subscription ended. A monitored download stops receiving new matches once its subscription ends", "type": "string", "format": "date-time" }, "url": { "type": "string", "example": "https://ownr.dk/api/v2/segments/downloads/42" } }, "type": "object" } }, "count": { "description": "The total number of records in the result set", "type": "integer", "example": 6 }, "page": { "description": "The current page displayed", "type": "integer", "example": 1 }, "pageCount": { "description": "Total number of pages", "type": "integer", "example": 1 }, "nextPageUrl": { "type": "string", "example": null, "nullable": true }, "prevPageUrl": { "type": "string", "example": null, "nullable": true } }, "type": "object" } }, "type": "object" } } } } }, "security": [ { "oauth2": [ "companies" ] }, { "oauth2": [ "persons" ] }, { "oauth2": [ "properties" ] } ] } }, "/segments/downloads/{id}": { "get": { "tags": [ "segments" ], "summary": "Get one purchased segment, with its matched entities", "operationId": "segmentsDownloadGet", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }, { "name": "page", "in": "query", "description": "Page number", "schema": { "type": "integer", "default": 1 } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "id": { "type": "integer", "example": 42 }, "type": { "type": "string", "enum": [ "company", "person", "property" ], "example": "property" }, "title": { "type": "string", "example": "Segment d. 12.03.2026 14:20:00" }, "size": { "description": "Number of entities matching the filters now. A watched segment keeps the rows of entities that left it, with `afgangsdato` set, so the rows of the download can outnumber it", "type": "integer", "example": 318 }, "is_paid": { "type": "boolean", "example": true }, "is_watched": { "type": "boolean", "example": false }, "created": { "type": "string", "format": "date-time" }, "expires": { "description": "Until when the rows can be read, after that `GET /segments/downloads/{id}` answers 404 and the download is deleted. An unpaid download expires 30 days after it was made; a paid one 3 years after it was paid, or, when it was monitored, 3 years after its subscription ended. A monitored download stops receiving new matches once its subscription ends", "type": "string", "format": "date-time" }, "url": { "type": "string", "example": "https://ownr.dk/api/v2/segments/downloads/42" }, "items": { "description": "The rows of the download, one key/value object per row — the same columns the CSV/XLSX export carries, typed: dates as `YYYY-MM-DD`, amounts as integers with their unit in `{column}_unit` (e.g. `purchase_price` 5750000 and `purchase_price_unit` `DKK`; a unit starting with `'` is in thousands, as `unit` of a report), counts and ids as integers, `zip` as a string, a missing value as `null`. A value the user edited in the segment and that does not parse is returned as typed. `tilgangsdato` is when the entity entered the segment, `afgangsdato` when it left it (`null` while it still matches)", "type": "array", "items": { "oneOf": [ { "$ref": "#/components/schemas/SegmentRowCompany" }, { "$ref": "#/components/schemas/SegmentRowPerson" }, { "$ref": "#/components/schemas/SegmentRowProperty" } ] } }, "count": { "description": "The total number of rows, those that left the segment included", "type": "integer", "example": 318 }, "page": { "description": "The current page displayed", "type": "integer", "example": 1 }, "pageCount": { "description": "Total number of pages", "type": "integer", "example": 13 }, "nextPageUrl": { "type": "string", "example": null, "nullable": true }, "prevPageUrl": { "type": "string", "example": null, "nullable": true } }, "type": "object" } }, "type": "object" } } } }, "402": { "description": "Segment not paid yet", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Segment not paid yet", "properties": { "status": { "type": "string", "default": "error" }, "error": { "properties": { "code": { "type": "integer", "default": 402 }, "message": { "type": "string", "default": "This segment has not been purchased yet." }, "checkout_url": { "type": "string", "example": "https://ownr.dk/scout/billing-details/segments/download/42" } }, "type": "object" } }, "type": "object" } } } }, "404": { "description": "Segment not found, or expired (see `expires`)", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Segment not found or expired", "properties": { "status": { "type": "string", "default": "error" }, "error": { "properties": { "code": { "type": "integer", "default": 404 }, "message": { "type": "string", "enum": [ "Record not found", "This segment has expired" ], "example": "This segment has expired" } }, "type": "object" } }, "type": "object" } } } }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "companies" ] }, { "oauth2": [ "persons" ] }, { "oauth2": [ "properties" ] } ] } }, "/pipelines": { "get": { "tags": [ "pipeline" ], "summary": "List pipelines", "operationId": "pipelinesGet", "parameters": [ { "name": "page", "in": "query", "description": "Page number", "schema": { "type": "integer" } }, { "name": "sort", "in": "query", "schema": { "type": "string", "default": "created_at", "enum": [ "created_at", "updated_at", "name" ] } }, { "name": "direction", "in": "query", "schema": { "type": "string", "default": "desc", "enum": [ "asc", "desc" ] } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/Pipeline" } }, "total": { "description": "The same as `count`", "type": "integer", "example": 4 }, "count": { "description": "The total number of records in the result set", "type": "integer", "example": 4 }, "page": { "description": "The current page displayed", "type": "integer", "example": 1 }, "pageCount": { "description": "Total number of pages", "type": "integer", "example": 1 }, "nextPageUrl": { "type": "string", "example": null, "nullable": true }, "prevPageUrl": { "type": "string", "example": null, "nullable": true } }, "type": "object" } }, "type": "object" } } } }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "pipeline" ] } ] }, "post": { "tags": [ "pipeline" ], "summary": "Create an empty pipeline", "description": "Creates a pipeline. Creating a pipeline never consumes capacity — only leads do — so this call cannot return 402.", "operationId": "pipelinesPost", "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "name", "entity_type" ], "properties": { "name": { "type": "string", "maxLength": 48, "example": "Egne kunder Q4" }, "entity_type": { "description": "Fixed at creation and cannot be changed afterwards", "type": "string", "enum": [ "company", "person", "property" ], "example": "company" }, "stages": { "description": "Optional. Names of brand-new custom stages to create — not a selection from the default set. Nye leads, Vundet and Tabt always exist and cannot be removed; anything given here is inserted between them. Omit to keep the standard 8-stage set", "type": "array", "items": { "type": "string" }, "example": [ "Custom Stage 1", "Custom Stage 2" ] } }, "type": "object" } } } }, "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/Pipeline" } }, "type": "object" } }, "type": "object" } } } }, "400": { "$ref": "#/components/responses/400" }, "409": { "$ref": "#/components/responses/409" } }, "security": [ { "oauth2": [ "pipeline" ] } ] } }, "/pipelines/capacity": { "get": { "tags": [ "pipeline" ], "summary": "Lead capacity for the organisation", "description": "Call this before a large import to size the request. The same figures are returned inside the 402 when an import is refused, so a preflight is an optimisation, not a requirement.", "operationId": "pipelineCapacityGet", "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "capacity": { "$ref": "#/components/schemas/Capacity" } }, "type": "object" } }, "type": "object" } } } }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "pipeline" ] } ] } }, "/pipelines/{pipelineId}": { "get": { "tags": [ "pipeline" ], "summary": "Get a pipeline", "operationId": "pipelineGet", "parameters": [ { "name": "pipelineId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/Pipeline" } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "pipeline" ] } ] }, "delete": { "tags": [ "pipeline" ], "summary": "Delete a pipeline", "description": "Deleting a pipeline releases the capacity its leads occupied. Archiving does not.", "operationId": "pipelineDelete", "parameters": [ { "name": "pipelineId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "deleted": { "type": "boolean", "example": true }, "capacity": { "$ref": "#/components/schemas/Capacity" } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "pipeline" ] } ] } }, "/pipelines/{pipelineId}/stages/{stageId}": { "patch": { "tags": [ "pipeline" ], "summary": "Rename a stage", "description": "Works on both locked (system) and custom stages. The 3 fixed stages (Nye leads/Vundet/Tabt) can be renamed but not removed or reordered.", "operationId": "pipelineStageUpdate", "parameters": [ { "name": "pipelineId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "stageId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "name" ], "properties": { "name": { "type": "string", "maxLength": 100, "example": "Kontaktet igen" } }, "type": "object" } } } }, "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "properties": { "id": { "type": "integer", "format": "int64", "example": 1231 }, "name": { "type": "string", "example": "Kontaktet igen" }, "stage_key": { "type": "string", "example": null, "nullable": true }, "locked": { "type": "boolean", "example": false }, "lead_count": { "type": "integer", "example": 0 } }, "type": "object" } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "pipeline" ] } ] } }, "/pipelines/{pipelineId}/leads": { "get": { "tags": [ "pipeline" ], "summary": "List leads in a pipeline", "operationId": "pipelineLeadsGet", "parameters": [ { "name": "pipelineId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "stage", "in": "query", "description": "Filter by stage id", "schema": { "type": "integer", "format": "int64" } }, { "name": "page", "in": "query", "description": "Page number", "schema": { "type": "integer" } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "items": { "description": "Ordered by the time the lead was added", "type": "array", "items": { "$ref": "#/components/schemas/Lead" } }, "total": { "description": "The same as `count`", "type": "integer", "example": 412 }, "count": { "description": "The total number of records in the result set", "type": "integer", "example": 412 }, "page": { "description": "The current page displayed", "type": "integer", "example": 1 }, "pageCount": { "description": "Total number of pages", "type": "integer", "example": 21 }, "nextPageUrl": { "type": "string", "example": "https://ownr.dk/api/v2/pipelines/7/leads?page=2", "nullable": true }, "prevPageUrl": { "type": "string", "example": null, "nullable": true } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "pipeline" ] } ] }, "post": { "tags": [ "pipeline" ], "summary": "Add leads to a pipeline", "description": "Adds companies by CVR. Atomic by default: if the batch does not fit the organisation's capacity, nothing is imported and 402 is returned with the exact shortfall. Send partial=true to import as many as fit instead. Duplicates already in the pipeline are skipped and reported, not treated as errors.", "operationId": "pipelineLeadsPost", "parameters": [ { "name": "pipelineId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "cvr" ], "properties": { "cvr": { "type": "array", "items": { "type": "integer", "format": "int64" }, "maxItems": 10000, "example": [ 36408820, 24256790, 31183146 ] }, "stage": { "description": "Stage id to land in. Defaults to the first stage.", "type": "integer", "format": "int64" }, "partial": { "description": "When true, import as many as capacity allows instead of refusing the batch", "type": "boolean", "default": false } }, "type": "object" } } } }, "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "added": { "type": "integer", "example": 409 }, "skipped_duplicates": { "type": "integer", "example": 3 }, "invalid_cvr": { "type": "array", "items": { "type": "integer", "format": "int64" }, "example": [ 12345678 ] }, "partial": { "type": "boolean", "example": false }, "capacity": { "$ref": "#/components/schemas/Capacity" } }, "type": "object" } }, "type": "object" } } } }, "402": { "$ref": "#/components/responses/402" }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "pipeline" ] } ] } }, "/pipelines/{pipelineId}/leads/{leadId}": { "delete": { "tags": [ "pipeline" ], "summary": "Remove a lead from a pipeline", "description": "Removing a lead releases its capacity immediately.", "operationId": "pipelineLeadDelete", "parameters": [ { "name": "pipelineId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "leadId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "deleted": { "type": "boolean", "example": true }, "capacity": { "$ref": "#/components/schemas/Capacity" } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "pipeline" ] } ] }, "patch": { "tags": [ "pipeline" ], "summary": "Move a lead to another stage", "description": "Same effects as dragging the card in the web app: logs the move, notifies team members following the target stage, and — moving into Vundet with ajour_auto_add enabled — adds the lead to Ajour.", "operationId": "pipelineLeadUpdate", "parameters": [ { "name": "pipelineId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "leadId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "stage" ], "properties": { "stage": { "description": "Target stage id", "type": "integer", "format": "int64", "example": 1297 } }, "type": "object" } } } }, "responses": { "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "429": { "$ref": "#/components/responses/429" }, "200": { "description": "Request success", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Request success", "properties": { "status": { "type": "string", "default": "success" }, "data": { "properties": { "item": { "$ref": "#/components/schemas/Lead" } }, "type": "object" } }, "type": "object" } } } }, "404": { "$ref": "#/components/responses/404" }, "400": { "$ref": "#/components/responses/400" } }, "security": [ { "oauth2": [ "pipeline" ] } ] } } }, "components": { "schemas": { "CompanyEmployees": { "properties": { "employees_monthly": { "description": "Monthly, from October 2019. Newest first", "type": "array", "items": { "properties": { "year": { "type": "integer", "example": 2026 }, "month": { "type": "integer", "example": 7 }, "number": { "type": "integer", "example": 27279, "nullable": true }, "fte": { "type": "number", "example": 26308, "nullable": true }, "number_range": { "description": "Bucketed range instead of an exact count, when the exact value isn't disclosed", "type": "string", "example": "ANTAL_1000_999999", "nullable": true }, "fte_range": { "type": "string", "example": "ANTAL_1000_999999", "nullable": true } }, "type": "object" } }, "employees_quarterly": { "description": "Quarterly, reported until the third quarter of 2019, when the monthly figures replaced them. Newest first", "type": "array", "items": { "properties": { "year": { "type": "integer", "example": 2019 }, "quarter": { "type": "integer", "example": 3 }, "number": { "type": "integer", "example": 16098, "nullable": true }, "fte": { "type": "number", "example": 15664, "nullable": true }, "number_range": { "type": "string", "example": "ANTAL_1000_999999", "nullable": true }, "fte_range": { "type": "string", "example": "ANTAL_1000_999999", "nullable": true } }, "type": "object" } }, "employees_yearly": { "description": "Yearly, the older figures CVR reported until 2018. Newest first", "type": "array", "items": { "properties": { "year": { "type": "integer", "example": 2018 }, "number": { "type": "integer", "example": 16125, "nullable": true }, "fte": { "type": "number", "example": 16466, "nullable": true }, "number_range": { "type": "string", "example": "ANTAL_1000_999999", "nullable": true }, "fte_range": { "type": "string", "example": "ANTAL_1000_999999", "nullable": true } }, "type": "object" } } }, "type": "object" }, "ReportFigure": { "properties": { "value": { "description": "In the latest report", "type": "number", "example": 130540000000, "nullable": true }, "previous": { "description": "In the report before it", "type": "number", "example": 127191000000, "nullable": true } }, "type": "object" }, "PropertySummary": { "properties": { "id": { "type": "string", "example": "0a3f5088-0f97-32b8-e044-0003ba298018", "nullable": true }, "slug": { "type": "string", "default": "property" }, "url": { "type": "string", "example": "/api/v2/property/0a3f5088-0f97-32b8-e044-0003ba298018", "nullable": true }, "address_1": { "type": "string", "example": "Tybrindvej 10" }, "address_2": { "type": "string", "example": "Husby" }, "zip": { "type": "string", "example": "5592" }, "city": { "type": "string", "example": "Ejby" }, "country": { "type": "string", "example": "DK" }, "restricted": { "description": "Fields your plan does not include; each is `null`. Present only when something is hidden.", "type": "array", "items": { "type": "string" }, "example": [ "id", "url", "address_1", "address_2" ] } }, "type": "object" }, "CompanySummary": { "properties": { "id": { "type": "integer", "format": "int64", "example": 36473606 }, "slug": { "type": "string", "default": "company" }, "url": { "type": "string", "example": "/api/v2/company/36473606" }, "name": { "type": "string", "example": "WEB CODERS ApS" } }, "type": "object" }, "PersonSummary": { "properties": { "id": { "type": "integer", "format": "int64", "example": 4000528644 }, "slug": { "type": "string", "default": "person" }, "url": { "type": "string", "example": "/api/v2/person/4000528644" }, "name": { "type": "string", "example": "Mick Stjernelykke" } }, "type": "object" }, "TechnicalInstallation": { "properties": { "installation_number": { "type": "integer", "example": 1 }, "installation_year": { "type": "integer", "example": 2004 }, "decommission_year": { "type": "integer", "example": null, "nullable": true }, "classification": { "description": "tek020Klassifikation: 1110 (Tank), 1120 (Silo), 1130 (Gasbeholder), 1140 (Affaldsbeholder), 1150 (Udskiller), 1210 (Vindmølle), 1220 (Slanger til jordvarme), 1230 (Solcelleanlæg), 1235 (Solvarmeanlæg), 1240 (Nødstrømsforsyningsanlæg), 1250 (Transformerstation), 1255 (Oliefyr), 1260 (Elskab), 1265 (Naturgasfyr), 1270 ((UDFASES) Andet energiproducerende eller - distribuerende anlæg), 1275 (Halmfyr), 1280 (Biogasanlæg), 1285 (Pillefyr), 1290 (Brændeovn), 1295 (Andet energianlæg), 1310 (Vandtårn), 1320 (Pumpestation), 1330 (Swimmingpool), 1340 (Privat rensningsanlæg), 1350 (Offentlige rensningsanlæg), 1360 (Regnvandsanlæg), 1905 (Legeplads), 1910 (Teknikhus), 1915 (Døgnpostboks), 1920 (Køleanlæg), 1925 (Kunstværk), 1930 (Sirene / mast med sirene), 1935 (Skilt), 1940 (Antenne og mast med antenne), 1945 (Dambrug), 1950 (Møddingsanlæg), 1955 (Andet teknisk anlæg), 1960 (Ensilageanlæg), 1965 (Planlager), 1970 (Fortidsminde, historisk ruin)", "properties": { "code": { "type": "integer", "enum": [ 1110, 1120, 1130, 1140, 1150, 1210, 1220, 1230, 1235, 1240, 1250, 1255, 1260, 1265, 1270, 1275, 1280, 1285, 1290, 1295, 1310, 1320, 1330, 1340, 1350, 1360, 1905, 1910, 1915, 1920, 1925, 1930, 1935, 1940, 1945, 1950, 1955, 1960, 1965, 1970 ], "example": 1230 }, "text": { "type": "string", "example": "Solcelleanlæg" } }, "type": "object", "nullable": true }, "fabrication_type": { "type": "string", "example": null, "nullable": true }, "reconstruction_or_extension_year": { "type": "integer", "example": null, "nullable": true }, "size_class": { "description": "tek026StørrelsesklasseOlietank: 1 (Under 6.000 l), 2 (6.000 l - 100.000 l), 3 (Over 100.000 l)", "properties": { "code": { "type": "integer", "enum": [ 1, 2, 3 ], "example": 1 }, "text": { "type": "string", "example": "Under 6.000 l" } }, "type": "object", "nullable": true }, "placement": { "description": "tek027Placering: 0 (Ukendt), 1 (Nedgravet), 2 (Over terræn, udendørs), 3 (Indendørs)", "properties": { "code": { "type": "integer", "enum": [ 0, 1, 2, 3 ], "example": 1 }, "text": { "type": "string", "example": "Nedgravet" } }, "type": "object", "nullable": true }, "decommission": { "description": "tek028SløjfningOlietank: 1 (Tanken er afblændet), 2 (Tanken er tømt og afblændet), 3 (Tanken er tømt, afblændet og opfyldt), 4 (Tanken er tømt, afblændet og påfyldningsstuds samt udluftningsrør afmonteret), 10 (Jordvarmeslangerne er sløjfet/taget ud af drift)", "properties": { "code": { "type": "integer", "enum": [ 1, 2, 3, 4, 10 ], "example": 2 }, "text": { "type": "string", "example": "Tanken er tømt og afblændet" } }, "type": "object", "nullable": true }, "fabrication_number": { "type": "string", "example": "09R3577" }, "type_approval_number": { "type": "string", "example": "55-5820" }, "size": { "type": "integer", "example": 1225 }, "oil_tank_content": { "description": "tek034IndholdOlietank: 10 (Mineralske olieprodukter (Olietankbekendtgørelsens §5, nr. 13)), 11 (Fuelolie (”tung fuelolie” - kræver opvarmning)), 12 (Fyringsgasolie), 13 (Autogasolie (Dieselolie)), 14 (Benzin), 20 (Biobrændstoffer (Organiske olieprodukter som f.eks. rapsolie, bioethanol m.v.)), 30 (Affaldsprodukter), 31 (Oliebaserede affaldsprodukter (Spildolie)), 40 (Gylle), 50 (Ajle, ensilagesaft, mælkerumsvand eller møddingvand), 60 (Øvrige stoffer, produkter og materialer der kan forurene grundvand, jord og undergrund (§ 19)), 70 (Korn), 99 (Andet (f.eks. foderstoffer m.v))", "properties": { "code": { "type": "integer", "enum": [ 10, 11, 12, 13, 14, 20, 30, 31, 40, 50, 60, 70, 99 ], "example": 10 }, "text": { "type": "string", "example": "Mineralske olieprodukter (Olietankbekendtgørelsens §5, nr. 13)" } }, "type": "object", "nullable": true }, "volume": { "type": "integer", "example": null, "nullable": true }, "area": { "type": "integer", "example": null, "nullable": true }, "height": { "type": "integer", "example": null, "nullable": true }, "power": { "type": "integer", "example": null, "nullable": true }, "revision_date": { "type": "string", "format": "date", "example": "2019-01-08" }, "material": { "type": "string", "example": "1" }, "hub_height": { "type": "number", "example": null, "nullable": true }, "wind_turbine_number": { "type": "string", "example": null, "nullable": true }, "rotor_diameter": { "type": "number", "example": null, "nullable": true }, "validity_date": { "type": "string", "format": "date", "example": null, "nullable": true }, "operation_status": { "description": "tek110Driftstatus: 1 (I drift), 2 (Ikke i drift)", "properties": { "code": { "type": "integer", "enum": [ 1, 2 ], "example": 1 }, "text": { "type": "string", "example": "I drift" } }, "type": "object", "nullable": true }, "last_inspection_date": { "type": "string", "format": "date", "example": null, "nullable": true }, "inspecting_company": { "type": "string", "example": null, "nullable": true } }, "type": "object" }, "Pipeline": { "properties": { "id": { "type": "integer", "format": "int64", "example": 189 }, "name": { "type": "string", "example": "Egne kunder Q4" }, "entity_type": { "type": "string", "enum": [ "company", "person", "property" ], "example": "company" }, "lead_count": { "type": "integer", "example": 0 }, "stages": { "type": "array", "items": { "properties": { "id": { "description": "Use this to target the stage in POST/GET leads", "type": "integer", "format": "int64", "example": 1231 }, "name": { "type": "string", "example": "Nye leads" }, "stage_key": { "description": "Set only for the 8 system stages (new/contacted/follow_up/in_dialog/offer_sent/follow_up2/won/lost); null for custom stages. Informational only — always address a stage by id", "type": "string", "example": "new", "nullable": true }, "locked": { "type": "boolean", "example": true }, "lead_count": { "type": "integer", "example": 0 } }, "type": "object" } }, "created_at": { "type": "string", "format": "date-time", "example": "2026-08-04T09:14:22+02:00" }, "updated_at": { "description": "The latest activity in the pipeline: a lead added, moved to another stage or removed, or the pipeline itself changed", "type": "string", "format": "date-time" }, "url": { "type": "string", "example": "https://ownr.dk/pipelines/view/189" } }, "type": "object" }, "Lead": { "properties": { "id": { "type": "integer", "format": "int64", "example": 90311 }, "cvr": { "type": "integer", "format": "int64", "example": 36408820, "nullable": true }, "name": { "type": "string", "example": "ownr ApS" }, "stage": { "description": "Stage id — matches Pipeline.stages[].id", "type": "integer", "format": "int64", "example": 1231 }, "source": { "type": "string", "enum": [ "api", "csv", "manual", "segment" ], "example": "api" }, "counts_against_capacity": { "description": "false for leads that came from a segment", "type": "boolean", "example": true }, "created_at": { "type": "string", "format": "date-time", "example": "2026-08-04T09:20:41+02:00" } }, "type": "object" }, "Capacity": { "description": "Lead capacity is organisation-wide: every pipeline draws on the same pool. Leads that came from a segment are included with that segment and never counted here.", "properties": { "included": { "description": "Free base, always included", "type": "integer", "example": 250 }, "used": { "description": "Leads counting against capacity, all pipelines", "type": "integer", "example": 53 }, "limit": { "description": "Current ceiling (included, or the purchased tier)", "type": "integer", "example": 250 }, "available": { "type": "integer", "example": 197 }, "segment_leads": { "description": "Included with their segment; not counted", "type": "integer", "example": 202 }, "tier": { "properties": { "limit": { "type": "integer", "example": 250 }, "price_month": { "type": "number", "example": 0 }, "price_year": { "type": "number", "example": 0 }, "free": { "type": "boolean", "example": true } }, "type": "object" } }, "type": "object" }, "SegmentRowCompany": { "description": "A row of a company segment. A value the user edited in the segment and that does not parse is returned as typed", "properties": { "entity_key": { "type": "string", "example": "10403782", "nullable": true }, "cvr": { "type": "integer", "example": 10403782, "nullable": true }, "name": { "type": "string", "example": "LEGO A/S", "nullable": true }, "rating": { "type": "integer", "example": 0, "nullable": true }, "status": { "type": "string", "example": "Normal", "nullable": true }, "company_type": { "type": "string", "example": "Aktieselskab", "nullable": true }, "founded": { "type": "string", "format": "date", "nullable": true }, "employees_number": { "description": "An interval, or an integer when the number is exact", "type": "string", "example": "1000 - 999999", "nullable": true }, "sector": { "type": "string", "nullable": true }, "district": { "type": "string", "nullable": true }, "address": { "type": "string", "nullable": true }, "zip": { "type": "string", "example": "7190", "nullable": true }, "city": { "type": "string", "nullable": true }, "result_before_tax": { "type": "integer", "example": 1500000, "nullable": true }, "result_before_tax_unit": { "description": "Unit of the amount. One starting with `'` is in thousands", "type": "string", "example": "DKK", "nullable": true }, "equity": { "type": "integer", "example": 8200000, "nullable": true }, "equity_unit": { "description": "Unit of the amount. One starting with `'` is in thousands", "type": "string", "example": "DKK", "nullable": true }, "gross_profit": { "type": "integer", "example": 3100000, "nullable": true }, "gross_profit_unit": { "description": "Unit of the amount. One starting with `'` is in thousands", "type": "string", "example": "DKK", "nullable": true }, "phone": { "type": "string", "nullable": true }, "email": { "type": "string", "nullable": true }, "url": { "type": "string", "nullable": true }, "google": { "type": "string", "nullable": true }, "ownr_link": { "type": "string", "nullable": true }, "tilgangsdato": { "description": "When the entity entered the segment", "type": "string", "format": "date", "nullable": true }, "afgangsdato": { "description": "When it left the segment, `null` while it still matches", "type": "string", "format": "date", "nullable": true } }, "type": "object" }, "SegmentRowPerson": { "description": "A row of a person segment. A value the user edited in the segment and that does not parse is returned as typed", "properties": { "entity_key": { "type": "string", "example": "4003849063", "nullable": true }, "item_id": { "type": "integer", "example": 4003849063, "nullable": true }, "name": { "type": "string", "nullable": true }, "rating": { "type": "integer", "example": 0, "nullable": true }, "birthday": { "type": "string", "format": "date", "nullable": true }, "address": { "type": "string", "nullable": true }, "zip": { "type": "string", "nullable": true }, "city": { "type": "string", "nullable": true }, "postal_district": { "type": "string", "nullable": true }, "district": { "type": "string", "nullable": true }, "companies": { "description": "Companies the person is connected to", "type": "integer", "nullable": true }, "connections": { "type": "integer", "nullable": true }, "properties": { "type": "integer", "nullable": true }, "career_start": { "description": "Year", "type": "integer", "nullable": true }, "google": { "type": "string", "nullable": true }, "ownr_link": { "type": "string", "nullable": true }, "tilgangsdato": { "description": "When the entity entered the segment", "type": "string", "format": "date", "nullable": true }, "afgangsdato": { "description": "When it left the segment, `null` while it still matches", "type": "string", "format": "date", "nullable": true } }, "type": "object" }, "SegmentRowProperty": { "description": "A row of a property segment. A value the user edited in the segment and that does not parse is returned as typed", "properties": { "entity_key": { "type": "string", "nullable": true }, "bfe": { "type": "integer", "example": 5138982, "nullable": true }, "address": { "type": "string", "nullable": true }, "rating": { "type": "integer", "example": 0, "nullable": true }, "access_holder": { "description": "Owners, with their ownership percentage", "type": "string", "nullable": true }, "purchase_price": { "type": "integer", "example": 5750000, "nullable": true }, "purchase_price_unit": { "description": "Unit of the amount. One starting with `'` is in thousands", "type": "string", "example": "DKK", "nullable": true }, "trading_type": { "type": "string", "nullable": true }, "acquisition_date": { "type": "string", "format": "date", "nullable": true }, "transaction_date": { "type": "string", "format": "date", "nullable": true }, "deed_date": { "type": "string", "format": "date", "nullable": true }, "last_endorsement_date": { "type": "string", "format": "date", "nullable": true }, "ground_area": { "description": "m²", "type": "integer", "nullable": true }, "living_area": { "description": "m²", "type": "integer", "nullable": true }, "business_area": { "description": "m²", "type": "integer", "nullable": true }, "rooms": { "type": "integer", "nullable": true }, "toilets": { "type": "integer", "nullable": true }, "bathrooms": { "type": "integer", "nullable": true }, "property_type": { "type": "string", "nullable": true }, "anmelder_cvr": { "description": "Only with extended segmentation", "type": "integer", "nullable": true }, "anmelder": { "description": "Only with extended segmentation", "type": "string", "nullable": true }, "anmeldelsesdato": { "description": "Only with extended segmentation", "type": "string", "format": "date", "nullable": true }, "ejerlav": { "type": "string", "nullable": true }, "matrikel": { "type": "string", "nullable": true }, "ownership_state": { "type": "string", "nullable": true }, "boligtype": { "type": "string", "nullable": true }, "unit_usage": { "type": "string", "nullable": true }, "kitchen": { "type": "string", "nullable": true }, "property_value": { "type": "integer", "example": 4200000, "nullable": true }, "property_value_unit": { "description": "Unit of the amount. One starting with `'` is in thousands", "type": "string", "example": "DKK", "nullable": true }, "land_value": { "type": "integer", "example": 1300000, "nullable": true }, "land_value_unit": { "description": "Unit of the amount. One starting with `'` is in thousands", "type": "string", "example": "DKK", "nullable": true }, "sqm_price": { "type": "integer", "example": 42000, "nullable": true }, "sqm_price_unit": { "description": "Unit of the amount. One starting with `'` is in thousands", "type": "string", "example": "DKK", "nullable": true }, "ownr_link": { "type": "string", "nullable": true }, "tilgangsdato": { "description": "When the entity entered the segment", "type": "string", "format": "date", "nullable": true }, "afgangsdato": { "description": "When it left the segment, `null` while it still matches", "type": "string", "format": "date", "nullable": true } }, "type": "object" }, "CapacityShortfall": { "properties": { "required": { "description": "Leads this request would add", "type": "integer", "example": 412 }, "available": { "type": "integer", "example": 197 }, "shortfall": { "description": "How many the request is over by", "type": "integer", "example": 215 }, "used_after": { "description": "Organisation total if it were accepted", "type": "integer", "example": 465 }, "current_tier": { "type": "integer", "example": 250 }, "required_tier": { "description": "Smallest tier that would fit the request", "properties": { "limit": { "type": "integer", "example": 500 }, "price_month": { "type": "number", "example": 37.13 }, "price_year": { "type": "number", "example": 371 }, "discount_applied": { "type": "boolean", "example": true } }, "type": "object" }, "upgrade_url": { "type": "string", "example": "https://ownr.dk/pipelines/view/189/settings" } }, "type": "object" }, "TinglysningCode": { "properties": { "code": { "type": "string", "example": "skoede" }, "text": { "type": "string", "example": "Skøde" } }, "type": "object" }, "TinglysningAmount": { "properties": { "amount": { "type": "number", "example": 2150000 }, "currency": { "type": "string", "example": "DKK" } }, "type": "object" }, "TinglysningDocument": { "description": "Dato/løbenummer of a registered document.", "properties": { "identifier": { "description": "DokumentAliasIdentifikator, or AktHistoriskIdentifikator when the document isn't registered digitally", "type": "string", "example": "20180207-1009378557" }, "date_serial_number": { "description": "Dato/løbenummer as shown on tinglysning.dk", "type": "string", "example": "07.02.2018-1009378557", "nullable": true }, "tinglysnings_date": { "type": "string", "format": "date-time", "example": "2018-02-07T00:00:00+01:00", "nullable": true }, "is_digital": { "description": "`false` means: Dokumentet er ikke tinglyst digitalt og kan derfor ikke vises", "type": "boolean", "example": true }, "pdf_url": { "description": "Document PDF, fetched directly from tinglysning.dk; `null` when `is_digital` is `false` and for an Underpant. Site link: opens for a user logged in on ownr.dk with at least a Premium plan, not with the API token.", "type": "string", "example": "https://ownr.dk/property/syddanmark/middelfart/5592/tybrindvej/10/2705867/tinglysning?downloadPdf=atd&identifier=20180207-1009554767", "nullable": true } }, "type": "object" }, "TinglysningParty": { "properties": { "type": { "type": "string", "enum": [ "company", "person" ], "example": "company" }, "name": { "type": "string", "example": "Nykredit Realkredit A/S", "nullable": true }, "cvr": { "type": "string", "example": "12719280", "nullable": true }, "cpr": { "description": "Birth date with the serial part masked", "type": "string", "example": "240185-****", "nullable": true }, "address": { "type": "array", "items": { "type": "string" }, "example": [ "Kalvebod Brygge 1", "1780 København V" ] } }, "type": "object" }, "Tinglysning": { "description": "Tingbogsattest: everything shown on the property's Tingbogsattest page.", "properties": { "adkomster": { "description": "Newest first", "type": "array", "items": { "properties": { "document": { "oneOf": [ { "$ref": "#/components/schemas/TinglysningDocument" } ], "nullable": true }, "document_type": { "oneOf": [ { "$ref": "#/components/schemas/TinglysningCode" } ], "nullable": true, "description": "Dokumenttype" }, "access_holders": { "description": "Adkomsthavere", "type": "array", "items": { "type": "object", "allOf": [ { "$ref": "#/components/schemas/TinglysningParty" }, { "properties": { "ownership_share": { "description": "Ejerandel", "properties": { "numerator": { "type": "integer", "example": 1 }, "denominator": { "type": "integer", "example": 2 } }, "type": "object", "nullable": true } }, "type": "object" } ] } }, "purchase_price": { "description": "Købesum; `null` when no Kontant købesum is registered", "properties": { "currency": { "type": "string", "example": "DKK" }, "cash": { "description": "Kontant købesum", "type": "number", "example": 2150000, "nullable": true }, "inheritance_gift": { "description": "Købesummen omfatter beløb til arv/gave", "type": "number", "nullable": true }, "assumed_arrears": { "description": "Købesummen omfatter overtagne restancer af skatter og afgifter eller af andre ydelser", "type": "number", "nullable": true }, "redeemable_easements": { "description": "Købesummen omfatter servitutter, tinglyst på det købte, der kan forlanges afløst af en pengeydelse", "type": "number", "nullable": true }, "construction_contribution": { "description": "Købesummen omfatter beløb til anlægsbidrag til vej mv., der er forfaldent til betaling på tidspunktet for ejerskiftet", "type": "number", "nullable": true }, "total": { "description": "Købesum i alt", "type": "number", "example": 2150000, "nullable": true }, "acquisition_date": { "description": "Dato for overtagelse", "type": "string", "format": "date", "example": "2018-02-15", "nullable": true } }, "type": "object", "nullable": true } }, "type": "object" } }, "haeftelser": { "type": "array", "items": { "properties": { "is_afgiftspantebrev": { "type": "boolean", "example": false }, "document": { "oneOf": [ { "$ref": "#/components/schemas/TinglysningDocument" } ], "nullable": true }, "priority": { "description": "Prioritet", "type": "integer", "example": 1, "nullable": true }, "document_type": { "oneOf": [ { "$ref": "#/components/schemas/TinglysningCode" } ], "nullable": true, "description": "Dokumenttype" }, "principal": { "oneOf": [ { "$ref": "#/components/schemas/TinglysningAmount" } ], "nullable": true, "description": "Hovedstol" }, "interest_rate": { "description": "Rentesats (pålydende), %", "type": "number", "example": 1.5, "nullable": true }, "interest_rate_type": { "description": "Fast or variabel rente", "type": "string", "enum": [ "fixed", "variable" ], "nullable": true }, "reference_rate": { "description": "Referencerente of a variable rate", "properties": { "name": { "type": "string", "example": "nationalbankensIndskudsbevisrente", "nullable": true }, "rate": { "description": "Referencerentesats, %", "type": "number", "nullable": true }, "margin": { "description": "Tillæg (positive) or fradrag (negative), %", "type": "number", "example": 10, "nullable": true } }, "type": "object", "nullable": true }, "loan_type": { "oneOf": [ { "$ref": "#/components/schemas/TinglysningCode" } ], "nullable": true, "description": "Låntype" }, "special_loan_terms": { "description": "Særlige lånevilkår", "type": "array", "items": { "$ref": "#/components/schemas/TinglysningCode" } }, "latest_annotation_date": { "description": "Senest påtegnet dato", "type": "string", "format": "date-time", "nullable": true }, "latest_annotation_pdf_url": { "description": "Senest påtegnet PDF; `null` when there is no annotation or the document isn't registered digitally. Site link: opens for a user logged in on ownr.dk with at least a Premium plan, not with the API token.", "type": "string", "example": "https://ownr.dk/property/syddanmark/middelfart/5592/tybrindvej/10/2705867/tinglysning?downloadPdf=paategning&identifier=20210916-1013251360", "nullable": true }, "creditors": { "description": "Kreditorer", "type": "array", "items": { "$ref": "#/components/schemas/TinglysningParty" } }, "debtors": { "description": "Debitorer", "type": "array", "items": { "$ref": "#/components/schemas/TinglysningParty" } }, "authorized_agents": { "description": "Fuldmagtsbestemmelser", "type": "array", "items": { "$ref": "#/components/schemas/TinglysningParty" } }, "sub_mortgages": { "description": "Underpant", "type": "array", "items": { "properties": { "document": { "oneOf": [ { "$ref": "#/components/schemas/TinglysningDocument" } ], "nullable": true }, "priority": { "description": "Prioritet", "type": "integer", "nullable": true }, "amount": { "oneOf": [ { "$ref": "#/components/schemas/TinglysningAmount" } ], "nullable": true, "description": "Underpantsbeløb" }, "holders": { "description": "Underpanthavere", "type": "array", "items": { "$ref": "#/components/schemas/TinglysningParty" } } }, "type": "object" } } }, "type": "object" } }, "servitutter": { "type": "array", "items": { "properties": { "document": { "oneOf": [ { "$ref": "#/components/schemas/TinglysningDocument" } ], "nullable": true }, "priority": { "description": "Prioritet", "type": "integer", "nullable": true }, "document_type": { "oneOf": [ { "$ref": "#/components/schemas/TinglysningCode" } ], "nullable": true, "description": "Dokumenttype" }, "summary": { "description": "Servitut tekst summarisk: what the servitut is about, also when it has no tillægstekst", "type": "string", "example": "kloakering", "nullable": true }, "content": { "description": "Servitutindhold: the sections the servitut is categorised under and the codes within each, as given by Tingbogen", "type": "array", "items": { "properties": { "section": { "$ref": "#/components/schemas/TinglysningCode" }, "codes": { "type": "array", "items": { "$ref": "#/components/schemas/TinglysningCode" } } }, "type": "object" } }, "can_be_registered_without_owner_consent": { "description": "Kan tinglyses uden ejers tiltrædelse", "type": "boolean", "nullable": true }, "has_priority_over_debt_and_easements": { "description": "Tinglyses med prioritet forud for gæld og servitutter", "type": "boolean", "nullable": true }, "affects_property_value": { "description": "Har betydning for ejendommens værdi", "type": "boolean", "nullable": true }, "also_registered_on_count": { "description": "Også tinglyst på: Antal", "type": "integer", "nullable": true }, "file_number": { "description": "Også tinglyst på: Akt nr", "type": "string", "nullable": true }, "additional_texts": { "description": "Tillægstekst", "type": "array", "items": { "properties": { "heading": { "type": "string", "example": "Byggelinje" }, "text": { "type": "string" } }, "type": "object" } }, "entitled_to_enforce": { "description": "Påtaleberettiget", "type": "array", "items": { "properties": { "name": { "type": "string", "nullable": true }, "cvr": { "type": "string", "nullable": true } }, "type": "object" } } }, "type": "object" } }, "other_information": { "description": "Øvrige oplysninger", "properties": { "assessments": { "description": "Ejendomsvurdering", "type": "array", "items": { "properties": { "property_value": { "oneOf": [ { "$ref": "#/components/schemas/TinglysningAmount" } ], "nullable": true }, "land_value": { "oneOf": [ { "$ref": "#/components/schemas/TinglysningAmount" } ], "nullable": true }, "assessment_date": { "description": "Vurderingsdato", "type": "string", "format": "date", "nullable": true }, "municipality_code": { "description": "Kommunekode", "type": "string", "nullable": true }, "municipal_property_number": { "description": "Ejendomsnummer (BBR-nr.)", "type": "string", "nullable": true } }, "type": "object" } }, "scanned_files": { "description": "Indskannet akt", "type": "array", "items": { "properties": { "file_number": { "description": "Akt nr", "type": "string", "example": "40_N_62" }, "pdf_url": { "description": "Site link: opens for a user logged in on ownr.dk with at least a Premium plan, not with the API token.", "type": "string", "example": "https://ownr.dk/property/syddanmark/middelfart/5592/tybrindvej/10/2705867/tinglysning?downloadPdf=indskannetakt&identifier=40_N_62" } }, "type": "object" } } }, "type": "object", "nullable": true }, "pdf_url": { "description": "Tingbogsattest PDF, fetched directly from tinglysning.dk. Site link: opens for a user logged in on ownr.dk with at least a Premium plan, not with the API token.", "type": "string", "example": "https://ownr.dk/property/syddanmark/middelfart/5592/tybrindvej/10/2705867/tinglysning?downloadPdf=ejendomsummarisk&identifier=2705867" } }, "type": "object" }, "ProductionUnit": { "properties": { "id": { "type": "string", "example": "1030715892" }, "slug": { "type": "string", "default": "p_unit" }, "url": { "type": "string", "example": "/api/v2/p-unit/1030715892" }, "p_number": { "type": "string", "example": "1030715892" }, "name": { "type": "string", "example": "Origix ApS", "nullable": true }, "status": { "type": "string", "example": "AKTIV" }, "start_date": { "type": "string", "format": "date", "example": "2024-09-18", "nullable": true }, "ceased_date": { "type": "string", "format": "date", "example": null, "nullable": true }, "advertising_protected": { "type": "boolean", "example": true }, "address": { "oneOf": [ { "$ref": "#/components/schemas/PropertySummary" } ], "nullable": true, "description": "Also carries `coname` (the registry's raw care-of/attention name — can hold a private person's name, not modeled on `PropertySummary` since it's specific to this endpoint). Reduced to `zip`/`city`/`country` when the caller doesn't hold at least a Premium plan: `id`/`url`/`address_1`/`address_2`/`coname` are `null` and named in the object's `restricted`. Shown here in full, as if that plan were held." }, "address_owner": { "description": "Who owns the real estate at `address` — a company or a private person, not necessarily the same as `company` below (which is the unit's own operating company). Null when the address has no registered owner on file.", "properties": { "type": { "type": "string", "enum": [ "company", "person" ], "example": "company" }, "item": { "description": "Null when the caller doesn't hold at least a Premium plan — `address_owner.type` and the fact that a value exists are always visible, only the owner's identity requires that plan. Shown here as if that plan were held.", "properties": { "id": { "example": 45117049 }, "slug": { "type": "string", "example": "company" }, "url": { "type": "string", "example": "/api/v2/company/45117049" }, "name": { "type": "string", "example": "Origix ApS" } }, "type": "object", "nullable": true } }, "type": "object", "nullable": true }, "company": { "properties": { "id": { "type": "integer", "format": "int64", "example": 45117049 }, "slug": { "type": "string", "default": "company" }, "url": { "type": "string", "example": "/api/v2/company/45117049" } }, "type": "object", "nullable": true }, "sector": { "properties": { "code": { "type": "string", "example": "621000" }, "text": { "type": "string", "example": "Computerprogrammering" } }, "type": "object", "nullable": true }, "secondary_sectors": { "description": "Empty for this example unit — shown populated with a real value from another unit, to illustrate the shape", "type": "array", "items": { "properties": { "code": { "type": "string", "example": "782000" }, "text": { "type": "string", "example": "Vikarbureauer" } }, "type": "object" } }, "employees_number": { "properties": { "number": { "type": "integer", "example": 2 }, "fte": { "description": "Full time equivalent", "type": "number", "example": 1.21 }, "year": { "type": "integer", "example": 2026 }, "month": { "type": "integer", "example": 6 } }, "type": "object", "nullable": true }, "contacts": { "type": "array", "items": { "type": "string" }, "example": [ "contact@origix.io" ] }, "history": { "description": "Nothing is dropped from the raw registry record — every value the current fields above summarize also appears here with its full validity period", "properties": { "names": { "type": "array", "items": { "properties": { "name": { "type": "string", "example": "Origix ApS" }, "from": { "type": "string", "format": "date", "example": "2024-09-18", "nullable": true }, "to": { "type": "string", "format": "date", "nullable": true } }, "type": "object" } }, "addresses": { "description": "Same Premium-plan masking as the top-level `address`, including `coname` (see above): hidden fields are `null` and named in each address's `restricted`. Shown here in full, as if that plan were held.", "type": "array", "items": { "properties": { "address_1": { "type": "string", "example": "Tybrindvej 10" }, "address_2": { "type": "string", "example": "Husby" }, "zip": { "type": "string", "example": "5592" }, "city": { "type": "string", "example": "Ejby" }, "country": { "type": "string", "example": "DK" }, "from": { "type": "string", "format": "date", "example": "2024-09-18", "nullable": true }, "to": { "type": "string", "format": "date", "nullable": true } }, "type": "object" } }, "postal_addresses": { "description": "Same shape as addresses, including the Premium-plan masking of `address_1`/`address_2` — empty for this example unit (no separate mailing address registered); shown populated with a real value from another unit, to illustrate the shape", "type": "array", "items": { "properties": { "address_1": { "type": "string", "example": "Strandvejen 171" }, "address_2": { "type": "string", "example": "" }, "zip": { "type": "string", "example": "2900" }, "city": { "type": "string", "example": "Hellerup" }, "country": { "type": "string", "example": "DK" }, "from": { "type": "string", "format": "date", "example": "2002-04-09", "nullable": true }, "to": { "type": "string", "format": "date", "example": "2005-06-30", "nullable": true } }, "type": "object" } }, "sectors": { "type": "array", "items": { "properties": { "code": { "type": "string", "example": "621000" }, "text": { "type": "string", "example": "Computerprogrammering" }, "from": { "type": "string", "format": "date", "example": "2025-01-01", "nullable": true }, "to": { "type": "string", "format": "date", "nullable": true } }, "type": "object" } }, "secondary_sectors": { "description": "Empty for this example unit — shown populated with a real value from another unit, to illustrate the shape", "type": "array", "items": { "properties": { "code": { "type": "string", "example": "782000" }, "text": { "type": "string", "example": "Vikarbureauer" }, "from": { "type": "string", "format": "date", "example": "2016-11-22", "nullable": true }, "to": { "type": "string", "format": "date", "example": "2019-07-10", "nullable": true } }, "type": "object" } }, "employees_monthly": { "type": "array", "items": { "properties": { "year": { "type": "integer", "example": 2026 }, "month": { "type": "integer", "example": 6 }, "number": { "type": "integer", "example": 2, "nullable": true }, "fte": { "type": "number", "example": 1.21, "nullable": true }, "number_range": { "description": "Bucketed range instead of an exact count, when the exact value isn't disclosed", "type": "string", "example": "ANTAL_2_4", "nullable": true }, "fte_range": { "type": "string", "example": "ANTAL_1_1", "nullable": true } }, "type": "object" } }, "employees_quarterly": { "description": "Reported only before October 2019 — employees_monthly replaced it after that, so units registered later (like this example) never have any; shown populated with a real value from another, older unit, to illustrate the shape", "type": "array", "items": { "properties": { "year": { "type": "integer", "example": 2015 }, "quarter": { "type": "integer", "example": 2 }, "number": { "type": "integer", "example": 1, "nullable": true }, "fte": { "type": "number", "example": 1, "nullable": true }, "number_range": { "type": "string", "example": "ANTAL_1_1", "nullable": true }, "fte_range": { "type": "string", "example": "ANTAL_1_1", "nullable": true } }, "type": "object" } }, "employees_yearly": { "description": "Rarely populated — most units report monthly or quarterly instead; shown populated with a real value from another unit, to illustrate the shape", "type": "array", "items": { "properties": { "year": { "type": "integer", "example": 2002 }, "number": { "type": "integer", "example": 2, "nullable": true }, "fte": { "type": "number", "example": 1, "nullable": true }, "number_range": { "type": "string", "example": "ANTAL_2_4", "nullable": true }, "fte_range": { "type": "string", "example": "ANTAL_1_1", "nullable": true } }, "type": "object" } }, "lifecycle": { "type": "array", "items": { "properties": { "from": { "type": "string", "format": "date", "example": "2024-09-18", "nullable": true }, "to": { "type": "string", "format": "date", "nullable": true } }, "type": "object" } }, "company_relations": { "type": "array", "items": { "properties": { "cvr": { "type": "integer", "example": 45117049 }, "from": { "type": "string", "format": "date", "example": "2024-09-18", "nullable": true }, "to": { "type": "string", "format": "date", "nullable": true } }, "type": "object" } } }, "type": "object" }, "meta": { "description": "Registry/technical fields, kept for completeness", "properties": { "unit_number": { "type": "integer", "example": 4010179809 }, "unit_type": { "type": "string", "example": "PRODUKTIONSENHED" }, "sector_responsibility_code": { "type": "integer", "nullable": true }, "combined_id": { "type": "integer", "example": 19, "nullable": true }, "data_access": { "type": "integer", "example": 0, "nullable": true }, "last_loaded_at": { "type": "string", "example": "2026-09-14T04:34:07.588+02:00", "nullable": true }, "last_updated_at": { "type": "string", "example": "2024-12-28T09:57:12.000+01:00", "nullable": true }, "has_load_error": { "type": "boolean", "example": false }, "has_effect_error": { "type": "boolean", "example": false }, "error_description": { "type": "string", "nullable": true }, "effective_actor": { "type": "string", "example": "PO", "nullable": true }, "nearest_future_change_at": { "type": "string", "nullable": true } }, "type": "object" } }, "type": "object" } }, "responses": { "401": { "description": "Missing, invalid or expired access token", "content": { "application/json": { "schema": { "title": "Missing, invalid or expired access token", "properties": { "status": { "type": "string", "default": "error" }, "error": { "properties": { "code": { "type": "integer", "default": 401 }, "message": { "type": "string", "example": "invalid_token: The access token provided is invalid" } }, "type": "object" } }, "type": "object" } } } }, "403": { "description": "The access token does not have the scope this endpoint needs", "content": { "application/json": { "schema": { "title": "The access token does not have the scope this endpoint needs", "properties": { "status": { "type": "string", "default": "error" }, "error": { "properties": { "code": { "type": "integer", "default": 403 }, "message": { "type": "string", "example": "insufficient_scope: this endpoint requires the scope 'properties'" } }, "type": "object" } }, "type": "object" } } } }, "429": { "description": "Call quota or hourly rate limit reached. `Retry-After` gives the seconds to wait; when the quota is used up, `error.upgrade_url` links to where the tier is upgraded", "headers": { "Retry-After": { "description": "Seconds until the limit that was hit resets", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "title": "Call quota or hourly rate limit reached. `Retry-After` gives the seconds to wait", "properties": { "status": { "type": "string", "default": "error" }, "error": { "properties": { "code": { "type": "integer", "default": 429 }, "message": { "type": "string", "example": "Monthly call quota exceeded" } }, "type": "object" } }, "type": "object" } } } }, "AjourPaymentRequired": { "description": "Ajour needs a license or a purchased Ajour subscription, or the company already tracks the maximum of 50,000 customers", "content": { "application/json": { "schema": { "title": "Ajour needs a license or a purchased Ajour subscription", "properties": { "status": { "type": "string", "default": "error" }, "error": { "properties": { "code": { "type": "integer", "default": 402 }, "message": { "type": "string", "example": "Ajour requires a license or a purchased Ajour subscription." }, "upgrade_url": { "type": "string", "example": "https://ownr.dk/users/api-access" } }, "type": "object" } }, "type": "object" } } } }, "404": { "description": "Record not found", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Record not found", "properties": { "status": { "type": "string", "default": "error" }, "error": { "properties": { "code": { "type": "integer", "default": 404 }, "message": { "type": "string", "default": "Record not found" } }, "type": "object" } }, "type": "object" } } } }, "400": { "description": "Invalid ID supplied", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Invalid ID supplied", "properties": { "status": { "type": "string", "default": "error" }, "error": { "properties": { "code": { "type": "integer", "default": 400 }, "message": { "type": "string", "default": "Invalid ID supplied" } }, "type": "object" } }, "type": "object" } } } }, "409": { "description": "Conflict", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Conflict", "properties": { "status": { "type": "string", "default": "error" }, "error": { "properties": { "code": { "type": "integer", "default": 409 }, "message": { "type": "string", "default": "A pipeline with that name already exists" } }, "type": "object" } }, "type": "object" } } } }, "402": { "description": "Insufficient lead capacity", "headers": { "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "title": "Insufficient lead capacity", "properties": { "status": { "type": "string", "default": "error" }, "error": { "properties": { "code": { "type": "integer", "default": 402 }, "message": { "type": "string", "default": "Ikke nok leadkapacitet. Anmodningen kræver 412 leads, men der er 197 tilbage af 250." }, "capacity": { "$ref": "#/components/schemas/CapacityShortfall" } }, "type": "object" } }, "type": "object" } } } } }, "parameters": { "beneficial_purpose": { "name": "beneficial_purpose", "in": "query", "description": "Purpose of the beneficial owners lookup, see `/beneficial-owners/purposes`. Required together with `beneficial_accept=1` to see beneficial owners.", "schema": { "type": "string", "enum": [ "K1", "K2", "K3", "F1", "F2", "F3", "F4", "F5", "F6", "F7", "F8", "F9", "F10", "F11", "F12", "F13", "F14", "F15", "L1", "L2", "L3", "L4", "L5", "L6", "L7", "L8", "L9", "L10", "L11", "L12", "L13" ] } }, "beneficial_accept": { "name": "beneficial_accept", "in": "query", "description": "Pass `1` to confirm the declaration of the chosen `beneficial_purpose`, see `/beneficial-owners/purposes`. Every lookup is logged with its purpose.", "schema": { "type": "integer", "enum": [ 1 ] } } }, "headers": { "X-RateLimit-Limit": { "description": "Calls allowed per hour", "schema": { "type": "integer", "format": "int32" } }, "X-RateLimit-Remaining": { "description": "Calls left in the current hour", "schema": { "type": "integer", "format": "int32" } }, "X-RateLimit-Reset": { "description": "Seconds until the hourly limit resets", "schema": { "type": "integer", "format": "int32" } }, "X-Quota-Limit": { "description": "Calls included in the current quota period. Sent by the endpoints that count against the quota", "schema": { "type": "integer", "format": "int32" } }, "X-Quota-Remaining": { "description": "Calls left in the current quota period", "schema": { "type": "integer", "format": "int32" } }, "X-Quota-Reset": { "description": "When the quota resets", "schema": { "type": "string", "format": "date-time" } } }, "securitySchemes": { "oauth2": { "type": "oauth2", "description": "OAuth 2.0 client credentials. Get the Client ID and Client secret in ownr+ under API Access. Send the token as `Authorization: Bearer `.", "flows": { "clientCredentials": { "tokenUrl": "https://ownr.dk/api/v2/token", "scopes": { "companies": "Companies, production units and annual reports: lookup, search, segment filter lookups, follow, and the list of followed companies", "persons": "Persons: lookup, search, segment filter lookups, follow, and the list of followed persons", "properties": "Properties: lookup, search, segment filter lookups, follow, and the list of followed properties", "ajour": "Add, check and remove companies, persons and properties in Ajour, and list the Ajour lists", "pipeline": "Pipelines, stages, leads and lead capacity" } } } } } }, "tags": [ { "name": "company", "description": "company" }, { "name": "beneficial owners", "description": "beneficial owners" }, { "name": "production-unit", "description": "production-unit" }, { "name": "report", "description": "report" }, { "name": "account", "description": "account" }, { "name": "person", "description": "person" }, { "name": "property", "description": "property" }, { "name": "segments", "description": "segments" }, { "name": "pipeline", "description": "pipeline" } ] }