Skip to main content
Preview a company's legal identity

Authorizations

Authorization
string
header
required

Personal API key sent as a bearer token, together with X-Organization-Id. The key must have at least the access level the endpoint requires (read, write or admin).

Headers

X-Organization-Id
string

The organization to act in. Required for personal API keys; list the organizations you can access with GET /v1/organizations.

Body

application/json
country
string
required

Two-letter code of the country the company is registered in.

Pattern: ^[A-Za-z]{2}$
registration_number
string | null

The registration number as printed; spaces, dots and hyphens are ignored. Optional. Where Watchdog knows the country's format it must fit it, check digit included (Norway: the nine-digit organization number). Omitted or blank means none.

Maximum string length: 100

Response

What saving the identity would store.

outcome
enum<string>
required

accepted: saving stores the identity as company shows, whatever the register says about it. invalid_number: the number's format or check digit is wrong, or it is another country's; saving refuses it.

Available options:
accepted,
invalid_number
company
object | null
required

What saving would store. Null unless accepted.