Organizations

Organizations represent businesses and entities from public registries such as the Norwegian Brønnøysund Register Centre (Brønnøysundregistrene). Use these endpoints to search for and retrieve company information including address, contact details, VAT status, and corporate structure.

Note: These endpoints are public and do not require authentication.

Endpoints

Method	Endpoint	Description
GET	/organizations	Search organizations
GET	/organizations/{id}	Get an organization

Query Parameters

The GET /organizations endpoint supports the following query parameters:

Parameter	Type	Required	Description
organization_number	string	No	Filter by organization number (exact match)
name	string	No	Search by organization name (partial match, case-insensitive)
country	string	No	Filter by country code, e.g. `NO` (default: all countries)
page	integer	No	Page number for pagination (default: 1)
per_page	integer	No	Number of items per page (default: 100)
with	string	No	Comma-separated list of relations to include: `roles`, `shareholders`

When both organization_number and country are supplied and no matching organization exists locally, GET /organizations fetches it on demand from Brønnøysundregistrene and upserts it before returning results — this only happens for country=NO; any other country falls back to a plain local lookup. This self-heals organizations that were never picked up by the hourly organization-sync worker (e.g. a company registered during a sync outage). A first-time lookup for a newly registered Norwegian organization may therefore take noticeably longer than a subsequent one.

Attributes

Attribute	Type	Description
id	integer	The unique ID of the organization
iso_6523_icd	string	ISO 6523 ICD identifier (e.g. `0192` for Norwegian organizations)
name	string	The registered name of the organization
phone	string	Phone number
address	string	Street address, line 1
address2	string	Street address, line 2
city	string	City
zip_code	string	Postal / zip code
country	string	Two-letter country code (ISO 3166-1 alpha-2)
organization_number	string	The official registration number (e.g. Norwegian org.nr.)
parent_organization_number	string	Registration number of the parent organization, if any
is_vat_liable	boolean	Whether the organization is registered for VAT
is_registered_business_registry	boolean	Whether the organization is registered in the business registry
industrial_classification_local	string	Local industry classification code (Norwegian SN2007)
business_entity_type	string	Legal entity type (e.g. `AS`, `ENK`, `DA`, `NUF`)
website	string	Company website URL
number_of_departments	integer	Number of registered departments
number_of_employees	integer	Number of employees
incorporation_date	date	Date the organization was incorporated
registration_date	date	Date the organization was registered
liquidation_date	date	Date of liquidation, if applicable
deletion_date	date	Date of deletion from the registry, if applicable
logo	string	URL to the organization’s logo (computed from website)

Relationships

Relationship	Type	Description
roles	OrganizationRole[]	Board members, CEO, and other organizational roles
shareholders	OrganizationShareholder[]	Shareholders and ownership information

Example Request

curl "https://api.snapbooks.no/v2/organizations?organization_number=123456789&country=NO"

Example Response

{
    "id": 42,
    "iso_6523_icd": "0192",
    "name": "Eksempel AS",
    "phone": "+47 12345678",
    "address": "Storgata 1",
    "address2": null,
    "city": "Oslo",
    "zip_code": "0150",
    "country": "NO",
    "organization_number": "123456789",
    "parent_organization_number": null,
    "is_vat_liable": true,
    "is_registered_business_registry": true,
    "industrial_classification_local": "62.010",
    "business_entity_type": "AS",
    "website": "https://eksempel.no",
    "number_of_departments": 1,
    "number_of_employees": 15,
    "incorporation_date": "2018-03-15",
    "registration_date": "2018-04-01",
    "liquidation_date": null,
    "deletion_date": null,
    "logo": "https://logo.clearbit.com/eksempel.no"
}

Notes

These endpoints are public and do not require an API token or OAuth2 authentication.
An organization is considered active when both liquidation_date and deletion_date are null.
The name parameter performs a case-insensitive substring search, making it useful for autocomplete lookups.
The logo field is dynamically computed from the organization’s website and may be null if no website is registered.
Norwegian organization numbers are 9-digit strings (e.g. "123456789").
Use the with parameter to include related data: ?with=roles,shareholders.
All dates are returned in ISO 8601 format.