curl --request PATCH \
--url https://api.watchdog.no/v1/companies/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"country": "<string>",
"registration_number": "<string>",
"registration_exception_reason": "<string>",
"description": "<string>"
}
'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
country: '<string>',
registration_number: '<string>',
registration_exception_reason: '<string>',
description: '<string>'
})
};
fetch('https://api.watchdog.no/v1/companies/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.watchdog.no/v1/companies/{id}"
payload = {
"name": "<string>",
"country": "<string>",
"registration_number": "<string>",
"registration_exception_reason": "<string>",
"description": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(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": "not_found",
"message": "The resource does not exist in the current organization.",
"request_id": "req_example"
}
}{
"error": {
"code": "company_exists",
"message": "Another company in the workspace has this registration number (company_exists), or the company changed while it was being saved.",
"request_id": "req_example"
}
}{
"error": {
"code": "invalid_registration_number",
"message": "The registration number does not fit the country's format, or it has no country.",
"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"
}
}Update a company
Changes the company’s name, description or legal identity. A changed country or registration number is checked against the country’s register where Watchdog has one; the register’s answer is shown, never a refusal. Invoices, purchase orders and recipients stay with the company.
curl --request PATCH \
--url https://api.watchdog.no/v1/companies/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"country": "<string>",
"registration_number": "<string>",
"registration_exception_reason": "<string>",
"description": "<string>"
}
'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
country: '<string>',
registration_number: '<string>',
registration_exception_reason: '<string>',
description: '<string>'
})
};
fetch('https://api.watchdog.no/v1/companies/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.watchdog.no/v1/companies/{id}"
payload = {
"name": "<string>",
"country": "<string>",
"registration_number": "<string>",
"registration_exception_reason": "<string>",
"description": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(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": "not_found",
"message": "The resource does not exist in the current organization.",
"request_id": "req_example"
}
}{
"error": {
"code": "company_exists",
"message": "Another company in the workspace has this registration number (company_exists), or the company changed while it was being saved.",
"request_id": "req_example"
}
}{
"error": {
"code": "invalid_registration_number",
"message": "The registration number does not fit the country's format, or it has no country.",
"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
The registration number as printed; spaces, dots and hyphens are ignored. Where Watchdog knows the country's format it must fit it, check digit included. Changing it renames the company to the name the register holds, unless name is given too.
100Response
The 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