Snapbooks logo Snapbooks Developer

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

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.