Look up a Norwegian legal entity

Retrieve registration details for a legal entity from Norway's Central Coordinating Register for Legal Entities (Enhetsregisteret), maintained by the Brønnøysund Register Centre. Every legal entity operating in Norway is assigned a unique 9-digit organization number and registered in this central register.

Usage

brreg_entity(
  org_nr,
  registry = c("auto", "enheter", "underenheter"),
  type = c("code", "label")
)

Arguments

org_nr

Character. A 9-digit Norwegian organization number. Validated using brreg_validate() before the API call.

registry

One of "auto" (default, tries enheter then underenheter), "enheter" (main entities only), or "underenheter" (sub-entities only). Sub-entities have different fields (e.g. overordnetEnhet for the parent entity, beliggenhetsadresse instead of forretningsadresse).

type

A type of variables: "code" (default) returns raw codes, "label" returns English labels for coded columns (legal form, NACE, sector, etc.), following the eurostat package's pattern.

Value

A tibble with one row and one column per API field. Column names follow the package field dictionary. Key columns include org_nr, name, legal_form, employees, founding_date, nace_1, municipality_code, bankrupt, and parent_org_nr. For deleted entities (HTTP 410), returns a tibble with columns org_nr, deleted, and deletion_date.

Details

Column names are translated from Norwegian to English via the package field dictionary (field_dict). API fields not in the dictionary pass through with auto-generated snake_case names, so new fields added by brreg are never silently dropped. Use brreg_label() to translate coded values (legal forms, NACE codes) to English descriptions.

See also

brreg_search() for querying multiple entities, brreg_label() for translating codes to English, field_dict for the column name mapping.

Other tidybrreg entity functions: brreg_board_summary(), brreg_children(), brreg_download(), brreg_roles(), brreg_roles_legal(), brreg_search(), brreg_underenheter(), brreg_update_fields(), brreg_updates()

Examples

if (FALSE) { # interactive() && curl::has_internet()
# Equinor ASA — Norway's largest company
brreg_entity("923609016")

# With English labels (eurostat pattern)
brreg_entity("923609016", type = "label")

# Or pipe to brreg_label() for more control
brreg_entity("923609016") |> brreg_label(code = "legal_form")
}