Company

Credential: a company's API key or OAuth token.

Retrieves the master data of the company your API key belongs to.

The company is resolved from the API key itself — there is no company parameter, and a key can never read another company's data.

Use Cases

• Connectivity check: The simplest authenticated call — verify your key works and confirm which company it is bound to before doing anything else.
• Document headers: Pull the legal name, VAT number, and address for rendering your own documents or syncing into another system.
• Localization: Use preferredLanguage and countryCode to localize communication generated on behalf of the company.
• Reading amounts correctly: accounting.baseCurrency is the currency every base-currency (functional) total on this API is denominated in, and accounting.currentFiscalYear gives the reporting window and whether it is still open for posting. Read them before interpreting any figure — a report that says totalOpenAmountBase says nothing about which currency that is.

Response Structure

• id: Unique identifier for the company (UUID)
• name: Legal/display company name
• email / billingEmail: Primary and billing contact addresses
• vat: VAT registration number (CVR in Denmark)
• address, city, postalCode, countryCode: Registered address (countryCode is ISO 3166-1 alpha-2, e.g. DK)
• phone: Phone number
• preferredLanguage: Language code used for company communication (e.g. da, en)
• contactPersonFirstName / contactPersonLastName: Primary contact person
• accounting.baseCurrency: The company's base (functional) currency (ISO 4217) — what every base-currency total on this API is denominated in
• accounting.currentFiscalYear: The accounting year containing today — startDate, endDate (both inclusive) and status (OPEN / CLOSED). null when no accounting year covers today

Fields without a value are returned as null.

Required Scope

• company-read

Performance

Results are cached for 5 seconds, so bursts of calls do not hit the database on every request.

Example Response

Code
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Acme Corporation",
  "email": "contact@acme.com",
  "vat": 12345678,
  "billingEmail": "billing@acme.com",
  "address": "123 Main Street",
  "city": "Copenhagen",
  "postalCode": "2100",
  "countryCode": "DK",
  "phone": "+45 12 34 56 78",
  "preferredLanguage": "da",
  "contactPersonFirstName": "John",
  "contactPersonLastName": "Doe",
  "accounting": {
    "baseCurrency": "DKK",
    "currentFiscalYear": {
      "startDate": "2026-01-01",
      "endDate": "2026-12-31",
      "status": "OPEN"
    }
  }
}