curl --request POST \
--url https://api.watchdog.no/v1/documents/upload \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"file_name": "invoice-2026-001.pdf",
"mime_type": "application/pdf",
"file_size": 48321
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
file_name: 'invoice-2026-001.pdf',
mime_type: 'application/pdf',
file_size: 48321
})
};
fetch('https://api.watchdog.no/v1/documents/upload', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.watchdog.no/v1/documents/upload"
payload = {
"file_name": "invoice-2026-001.pdf",
"mime_type": "application/pdf",
"file_size": 48321
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"existing": false,
"document_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"upload_url": "<string>",
"headers": {},
"expires_at": "2023-11-07T05:31:56Z"
}{
"existing": false,
"document_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"upload_url": "<string>",
"headers": {},
"expires_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": "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": "Uploads are temporarily unavailable. Retry after the Retry-After delay.",
"request_id": "req_example"
}
}Get a link to upload a document
Creates a document and returns a short-lived upload URL. PUT the file to upload_url with the returned headers before expires_at, then use document_id to import an invoice, attach it to an invoice, or link it to an agreement. If md5_checksum matches a document you already uploaded, that document is returned instead (200, existing: true) and no upload is needed.
curl --request POST \
--url https://api.watchdog.no/v1/documents/upload \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"file_name": "invoice-2026-001.pdf",
"mime_type": "application/pdf",
"file_size": 48321
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
file_name: 'invoice-2026-001.pdf',
mime_type: 'application/pdf',
file_size: 48321
})
};
fetch('https://api.watchdog.no/v1/documents/upload', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.watchdog.no/v1/documents/upload"
payload = {
"file_name": "invoice-2026-001.pdf",
"mime_type": "application/pdf",
"file_size": 48321
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"existing": false,
"document_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"upload_url": "<string>",
"headers": {},
"expires_at": "2023-11-07T05:31:56Z"
}{
"existing": false,
"document_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"upload_url": "<string>",
"headers": {},
"expires_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": "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": "Uploads are temporarily unavailable. Retry after the Retry-After delay.",
"request_id": "req_example"
}
}Authorizations
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
The organization to act in. Required for personal API keys; list the organizations you can access with GET /v1/organizations.
Body
1 - 255255^[a-z0-9!#$&^_.+-]+\/[a-z0-9!#$&^_.+-]+$100 <= x <= 52428800invoice, agreement, other Base64 MD5 of the file. If you already uploaded a document with the same checksum, size and category, that document is returned instead.
^[A-Za-z0-9+/]{22}==$