curl --request POST \
--url https://api.watchdog.no/v1/companies \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"country": "<string>"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({country: '<string>'})
};
fetch('https://api.watchdog.no/v1/companies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.watchdog.no/v1/companies"
payload = { "country": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"country": "<string>",
"registration_number": "<string>",
"registration_exception_reason": "<string>",
"description": "<string>",
"register": {
"name": "<string>",
"status": "confirmed",
"registered_name": "<string>",
"bankrupt": true,
"winding_up": true,
"checked_at": "2023-11-07T05:31:56Z"
},
"peppol_available": true,
"identity_problems": [
"missing_country"
],
"archived_at": "2023-11-07T05:31:56Z",
"erasure_requested_at": "2023-11-07T05:31:56Z"
}{
"error": {
"code": "validation_error",
"message": "The request is invalid. details lists up to 20 field errors. Request bodies are limited to 2 MiB.",
"request_id": "req_example"
}
}{
"error": {
"code": "invalid_token",
"message": "The bearer token is missing or invalid.",
"request_id": "req_example"
}
}{
"error": {
"code": "forbidden",
"message": "Access denied. The error code says why: forbidden, token_disabled, organization_required, insufficient_role or mfa_required.",
"request_id": "req_example"
}
}{
"error": {
"code": "company_exists",
"message": "Another company in the workspace has this registration number.",
"request_id": "req_example"
}
}{
"error": {
"code": "invalid_registration_number",
"message": "The registration number does not fit the country's format, or no name was given and the register holds none.",
"request_id": "req_example"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests. Wait for the Retry-After delay before retrying.",
"request_id": "req_example"
}
}{
"error": {
"code": "internal_error",
"message": "Unexpected server failure. Include the request ID when contacting support.",
"request_id": "req_example"
}
}{
"error": {
"code": "service_unavailable",
"message": "Temporarily unavailable. Retry after the Retry-After delay, when provided.",
"request_id": "req_example"
}
}Create a company
Adds a legal company to the workspace. Its country and registration number are checked as updateCompany checks them: the number’s format and check digit, then the country’s register where Watchdog has one, whose answer is shown, never a refusal. Without a name it takes the name the register holds. When it is the workspace’s second, connection companies with its registration number are linked to it, and the other connection companies stay with the first (listCompanyLinks). Members with access to all companies can access it at once; others need it added to their access. A company is not deleted; an Admin can archive it (archiveCompany).
curl --request POST \
--url https://api.watchdog.no/v1/companies \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"country": "<string>"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({country: '<string>'})
};
fetch('https://api.watchdog.no/v1/companies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.watchdog.no/v1/companies"
payload = { "country": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"country": "<string>",
"registration_number": "<string>",
"registration_exception_reason": "<string>",
"description": "<string>",
"register": {
"name": "<string>",
"status": "confirmed",
"registered_name": "<string>",
"bankrupt": true,
"winding_up": true,
"checked_at": "2023-11-07T05:31:56Z"
},
"peppol_available": true,
"identity_problems": [
"missing_country"
],
"archived_at": "2023-11-07T05:31:56Z",
"erasure_requested_at": "2023-11-07T05:31:56Z"
}{
"error": {
"code": "validation_error",
"message": "The request is invalid. details lists up to 20 field errors. Request bodies are limited to 2 MiB.",
"request_id": "req_example"
}
}{
"error": {
"code": "invalid_token",
"message": "The bearer token is missing or invalid.",
"request_id": "req_example"
}
}{
"error": {
"code": "forbidden",
"message": "Access denied. The error code says why: forbidden, token_disabled, organization_required, insufficient_role or mfa_required.",
"request_id": "req_example"
}
}{
"error": {
"code": "company_exists",
"message": "Another company in the workspace has this registration number.",
"request_id": "req_example"
}
}{
"error": {
"code": "invalid_registration_number",
"message": "The registration number does not fit the country's format, or no name was given and the register holds none.",
"request_id": "req_example"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests. Wait for the Retry-After delay before retrying.",
"request_id": "req_example"
}
}{
"error": {
"code": "internal_error",
"message": "Unexpected server failure. Include the request ID when contacting support.",
"request_id": "req_example"
}
}{
"error": {
"code": "service_unavailable",
"message": "Temporarily unavailable. Retry after the Retry-After delay, when provided.",
"request_id": "req_example"
}
}Authorizations
Headers
Body
Response
The new company.
What the company's legal identity still lacks; empty when complete. missing_country: no country. missing_registration_number: neither a number nor a reason for having none. not_in_register: the country's register holds no company with the number.
missing_country, missing_registration_number, not_in_register