{ "openapi": "3.0.1", "info": { "title": "Norway Company Register (Brreg) & Updates", "description": "Look up Norwegian companies by organisation number, search Brreg Enhetsregisteret by municipality, NACE, form and status, list subentities, and track register changes with a cursor. Official open data (NLOD).", "version": "0.1", "x-build-id": "whM4bmNsogMOC4axi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cliqtomedia~norway-brreg-company-register/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cliqtomedia-norway-brreg-company-register", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/cliqtomedia~norway-brreg-company-register/runs": { "post": { "operationId": "runs-sync-cliqtomedia-norway-brreg-company-register", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/cliqtomedia~norway-brreg-company-register/run-sync": { "post": { "operationId": "run-sync-cliqtomedia-norway-brreg-company-register", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "lookup", "search", "updates" ], "type": "string", "description": "lookup: exact lookup of organisation numbers (entities and subentities). search: filter the register by name, municipality, NACE code, organisation form, status, employees or registration date. updates: change events of the register (new, changed, deleted, removed units) since a date or since the nextUpdateId of a previous run.", "default": "lookup" }, "orgNumbers": { "title": "Organisation numbers", "maxItems": 100, "type": "array", "description": "Lookup mode: up to 100 Norwegian organisation numbers (organisasjonsnummer, 9 digits), e.g. 923609016. Spaces and NO … MVA are accepted (NO 923 609 016 MVA). Each number is looked up as an entity (hovedenhet) and, if not found, as a subentity (underenhet). Numbers with a wrong MOD11 check digit return a free error row without a request. Duplicates are looked up once.", "items": { "type": "string" } }, "includeSubentities": { "title": "Include subentities", "type": "boolean", "description": "Lookup and search mode: for each entity found, also output its subentities (underenheter, e.g. branches and workplaces) as separate rows, up to maxSubentitiesPerEntity. Each subentity row is a paid record. One extra request per entity.", "default": false }, "maxSubentitiesPerEntity": { "title": "Max subentities per entity", "minimum": 1, "maximum": 100, "type": "integer", "description": "Upper limit of subentity rows per entity when includeSubentities is on. subentitiesTotal in the entity row shows how many exist.", "default": 20 }, "searchTarget": { "title": "Search target", "enum": [ "entities", "subentities" ], "type": "string", "description": "Search mode: search legal units (entities) or establishments (subentities). Subentity search supports name, municipality, NACE, organisation form, VAT and employee filters only.", "default": "entities" }, "name": { "title": "Name contains", "maxLength": 180, "type": "string", "description": "Search mode: words in the registered name, e.g. equinor or rørlegger. Leave empty to filter only by the other fields." }, "municipalityNumbers": { "title": "Municipality numbers", "maxItems": 50, "type": "array", "description": "Search mode: 4-digit municipality (kommune) numbers, e.g. 0301 (Oslo), 4601 (Bergen), 5001 (Trondheim). Matches the business address (entities) or location address (subentities).", "items": { "type": "string" } }, "naceCodes": { "title": "NACE industry codes", "maxItems": 50, "type": "array", "description": "Search mode: NACE codes (SN2025) or prefixes, e.g. 62 (all IT services), 62.1 or 62.100.", "items": { "type": "string" } }, "orgForms": { "title": "Organisation forms", "maxItems": 20, "type": "array", "description": "Search mode: organisation form codes, e.g. AS (limited company), ASA, ENK (sole proprietorship), NUF (foreign branch), DA, SA, STI (foundation), BEDR (subentity).", "items": { "type": "string" } }, "bankrupt": { "title": "Bankrupt", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Search mode, entities only: any, only bankrupt (yes) or only not bankrupt (no).", "default": "any" }, "underLiquidation": { "title": "Under liquidation", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Search mode, entities only: any, only under liquidation (yes) or none (no).", "default": "any" }, "vatRegistered": { "title": "VAT registered", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Search mode: any, only VAT-registered (yes) or not VAT-registered (no).", "default": "any" }, "minEmployees": { "title": "Min employees", "minimum": 0, "type": "integer", "description": "Search mode: minimum registered employees. The register accepts 0, 1 or 5 and above." }, "maxEmployees": { "title": "Max employees", "minimum": 0, "type": "integer", "description": "Search mode: maximum registered employees. The register accepts 0 or 4 and above." }, "registeredFrom": { "title": "Registered from", "type": "string", "description": "Search mode, entities only: registered in Enhetsregisteret on or after this date (YYYY-MM-DD)." }, "registeredTo": { "title": "Registered to", "type": "string", "description": "Search mode, entities only: registered on or before this date (YYYY-MM-DD)." }, "maxResults": { "title": "Max search results", "minimum": 1, "maximum": 500, "type": "integer", "description": "Search mode: maximum rows returned (1–500). RUN_SUMMARY shows the total number of matches.", "default": 50 }, "updatesTarget": { "title": "Updates of", "enum": [ "entities", "subentities" ], "type": "string", "description": "Updates mode: change feed of entities or of subentities.", "default": "entities" }, "updatesSince": { "title": "Changes since", "type": "string", "description": "Updates mode: first run of a monitor: a date (2026-10-11, midnight UTC) or an ISO date-time with a time zone (2026-10-11T08:00:00Z). Not in the future." }, "updatesFromId": { "title": "Continue from update ID", "minimum": 1, "type": "integer", "description": "Updates mode: the nextUpdateId from the previous run’s RUN_SUMMARY. Continues exactly after the last delivered event, with no gaps or duplicates. Takes priority over updatesSince." }, "maxUpdates": { "title": "Max update events", "minimum": 1, "maximum": 500, "type": "integer", "description": "Updates mode: maximum events per run (1–500). If more are waiting, RUN_SUMMARY has hasMore=true; continue with nextUpdateId.", "default": 100 }, "includeRecordDetails": { "title": "Include current record details", "type": "boolean", "description": "Updates mode: add the current register record (name, form, address, status…) to each event. Off: only event ID, type, date, org number and changed field names.", "default": true }, "includeContactDetails": { "title": "Include e-mail and phone", "type": "boolean", "description": "Add registered e-mail, phone and mobile of entities. Never output for sole proprietorships (ENK) and their subentities, to protect natural persons. Use contact data only within the law (GDPR, Norwegian marketing law).", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }