Company

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.

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

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"
}