> ## Documentation Index > Fetch the complete documentation index at: https://docs.watchdog.no/llms.txt > Use this file to discover all available pages before exploring further. # Attach a claim credit note > Attaches a credit note to the claim. Set create_refund to also record a refund for the note amount; attaching alone records no refund. Attaching the same note twice returns 409. ## OpenAPI ````yaml /openapi.json post /v1/claims/{id}/credit-notes openapi: 3.1.0 info: title: Watchdog API version: 1.0.0 description: >- The Watchdog API is served from https://api.watchdog.no. Request bodies are limited to 2 MiB unless an endpoint says otherwise. Files are uploaded directly to storage, not through the API. servers: - url: https://api.watchdog.no description: Watchdog API security: [] paths: /v1/claims/{id}/credit-notes: post: tags: - Claims summary: Attach a claim credit note description: >- Attaches a credit note to the claim. Set create_refund to also record a refund for the note amount; attaching alone records no refund. Attaching the same note twice returns 409. operationId: attachClaimCreditNote parameters: - name: X-Organization-Id in: header required: false schema: type: string description: >- The organization to act in. Required for personal API keys; list the organizations you can access with GET /v1/organizations. - schema: type: string format: uuid required: true name: id in: path requestBody: required: true content: application/json: schema: type: object properties: credit_note_id: type: string format: uuid create_refund: type: boolean default: false required: - credit_note_id additionalProperties: false responses: '201': description: Attached credit note. headers: X-Request-Id: schema: type: string required: true description: >- Request ID, also included in error bodies. Include it when contacting support. Cache-Control: schema: type: string enum: - private, no-store - private, no-store, no-transform required: false description: API responses are private and must not be cached. X-RateLimit-Limit: schema: type: string example: '500' required: false description: >- Requests allowed per minute for this credential, or failed API key attempts allowed per minute from this IP address. Location: schema: type: string required: false description: Relative URL of the created or accepted resource. ETag: schema: type: string required: true description: >- Version of the resource. Send it as If-Match to change it only if it has not changed since. content: application/json: schema: $ref: '#/components/schemas/ClaimCreditNote' '400': description: >- The request is invalid. details lists up to 20 field errors. Request bodies are limited to 2 MiB. headers: X-Request-Id: schema: type: string required: true description: >- Request ID, also included in error bodies. Include it when contacting support. Cache-Control: schema: type: string enum: - private, no-store - private, no-store, no-transform required: false description: API responses are private and must not be cached. X-RateLimit-Limit: schema: type: string example: '500' required: false description: >- Requests allowed per minute for this credential, or failed API key attempts allowed per minute from this IP address. content: application/json: schema: $ref: '#/components/schemas/Error_validation_error' example: 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 '401': description: The bearer token is missing or invalid. headers: X-Request-Id: schema: type: string required: true description: >- Request ID, also included in error bodies. Include it when contacting support. Cache-Control: schema: type: string enum: - private, no-store - private, no-store, no-transform required: false description: API responses are private and must not be cached. X-RateLimit-Limit: schema: type: string example: '500' required: false description: >- Requests allowed per minute for this credential, or failed API key attempts allowed per minute from this IP address. WWW-Authenticate: schema: type: string required: false description: Bearer authentication challenge, when supplied. content: application/json: schema: $ref: '#/components/schemas/Error_invalid_token' example: error: code: invalid_token message: The bearer token is missing or invalid. request_id: req_example '403': description: >- Access denied. The error code says why: forbidden, token_disabled, organization_required, insufficient_role or mfa_required. headers: X-Request-Id: schema: type: string required: true description: >- Request ID, also included in error bodies. Include it when contacting support. Cache-Control: schema: type: string enum: - private, no-store - private, no-store, no-transform required: false description: API responses are private and must not be cached. X-RateLimit-Limit: schema: type: string example: '500' required: false description: >- Requests allowed per minute for this credential, or failed API key attempts allowed per minute from this IP address. content: application/json: schema: $ref: >- #/components/schemas/Error_forbidden_token_disabled_organization_required_insufficient_role_mfa_required 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 '404': description: The resource does not exist in the current organization. headers: X-Request-Id: schema: type: string required: true description: >- Request ID, also included in error bodies. Include it when contacting support. Cache-Control: schema: type: string enum: - private, no-store - private, no-store, no-transform required: false description: API responses are private and must not be cached. X-RateLimit-Limit: schema: type: string example: '500' required: false description: >- Requests allowed per minute for this credential, or failed API key attempts allowed per minute from this IP address. content: application/json: schema: $ref: '#/components/schemas/Error_not_found' example: error: code: not_found message: The resource does not exist in the current organization. request_id: req_example '409': description: The refund or credit note conflicts with the claim's current state. headers: X-Request-Id: schema: type: string required: true description: >- Request ID, also included in error bodies. Include it when contacting support. Cache-Control: schema: type: string enum: - private, no-store - private, no-store, no-transform required: false description: API responses are private and must not be cached. X-RateLimit-Limit: schema: type: string example: '500' required: false description: >- Requests allowed per minute for this credential, or failed API key attempts allowed per minute from this IP address. content: application/json: schema: $ref: '#/components/schemas/Error_conflict' example: error: code: conflict message: >- The refund or credit note conflicts with the claim's current state. request_id: req_example '429': description: Too many requests. Wait for the Retry-After delay before retrying. headers: X-Request-Id: schema: type: string required: true description: >- Request ID, also included in error bodies. Include it when contacting support. Cache-Control: schema: type: string enum: - private, no-store - private, no-store, no-transform required: false description: API responses are private and must not be cached. X-RateLimit-Limit: schema: type: string example: '500' required: false description: >- Requests allowed per minute for this credential, or failed API key attempts allowed per minute from this IP address. Retry-After: schema: type: string example: '60' required: true description: Seconds to wait before retrying the request. content: application/json: schema: $ref: '#/components/schemas/Error_rate_limit_exceeded' example: error: code: rate_limit_exceeded message: >- Too many requests. Wait for the Retry-After delay before retrying. request_id: req_example '500': description: >- Unexpected server failure. Include the request ID when contacting support. headers: X-Request-Id: schema: type: string required: true description: >- Request ID, also included in error bodies. Include it when contacting support. Cache-Control: schema: type: string enum: - private, no-store - private, no-store, no-transform required: false description: API responses are private and must not be cached. X-RateLimit-Limit: schema: type: string example: '500' required: false description: >- Requests allowed per minute for this credential, or failed API key attempts allowed per minute from this IP address. content: application/json: schema: $ref: '#/components/schemas/Error_internal_error' example: error: code: internal_error message: >- Unexpected server failure. Include the request ID when contacting support. request_id: req_example '503': description: >- Temporarily unavailable. Retry after the Retry-After delay, when provided. headers: X-Request-Id: schema: type: string required: true description: >- Request ID, also included in error bodies. Include it when contacting support. Cache-Control: schema: type: string enum: - private, no-store - private, no-store, no-transform required: false description: API responses are private and must not be cached. X-RateLimit-Limit: schema: type: string example: '500' required: false description: >- Requests allowed per minute for this credential, or failed API key attempts allowed per minute from this IP address. Retry-After: schema: type: string example: '60' required: true description: Seconds to wait before retrying the request. content: application/json: schema: $ref: '#/components/schemas/Error_service_unavailable' example: error: code: service_unavailable message: >- Temporarily unavailable. Retry after the Retry-After delay, when provided. request_id: req_example security: - ApiKeyBearer: [] components: schemas: ClaimCreditNote: type: object properties: credit_note: $ref: '#/components/schemas/InvoiceSummary' direct_attachment: type: - object - 'null' properties: attached_at: type: string format: date-time refund_created_by_attachment: type: boolean refund: allOf: - $ref: '#/components/schemas/ClaimRefund' - type: - object - 'null' required: - attached_at - refund_created_by_attachment - refund matched_invoices: type: array items: type: object properties: id: type: string format: uuid title: type: - string - 'null' required: - id - title description: >- Claim invoices this credit note is matched to; title is the invoice number. required: - credit_note - direct_attachment - matched_invoices Error_validation_error: type: object properties: error: type: object properties: code: type: string enum: - validation_error message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error Error_invalid_token: type: object properties: error: type: object properties: code: type: string enum: - invalid_token message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error Error_forbidden_token_disabled_organization_required_insufficient_role_mfa_required: type: object properties: error: type: object properties: code: type: string enum: - forbidden - token_disabled - organization_required - insufficient_role - mfa_required message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error Error_not_found: type: object properties: error: type: object properties: code: type: string enum: - not_found message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error Error_conflict: type: object properties: error: type: object properties: code: type: string enum: - conflict message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error Error_rate_limit_exceeded: type: object properties: error: type: object properties: code: type: string enum: - rate_limit_exceeded message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error Error_internal_error: type: object properties: error: type: object properties: code: type: string enum: - internal_error message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error Error_service_unavailable: type: object properties: error: type: object properties: code: type: string enum: - service_unavailable message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error InvoiceSummary: type: object properties: id: type: string format: uuid url: type: string format: uri description: The invoice in the Watchdog app. invoice_number: type: - string - 'null' title: type: - string - 'null' category: type: string enum: - invoice - credit_note - self_billed_invoice issued_date: type: - string - 'null' format: date due_date: type: - string - 'null' format: date created_at: type: string format: date-time updated_at: type: string format: date-time deleted_at: type: - string - 'null' format: date-time supplier: $ref: '#/components/schemas/InvoiceParty' recipient: $ref: '#/components/schemas/InvoiceParty' amounts: $ref: '#/components/schemas/InvoiceAmounts' review: $ref: '#/components/schemas/InvoiceReview' workflows: $ref: '#/components/schemas/InvoiceWorkflows' alerts: $ref: '#/components/schemas/InvoiceAlerts' relationships: type: object properties: agreement_count: type: integer minimum: 0 description: Matched agreements, listed at GET /v1/invoices/{id}/agreements. alert_count: type: integer minimum: 0 description: >- Alerts on the invoice, including dismissed and outdated ones, listed at GET /v1/alerts?invoice_ids={id}. linked_credit_note_count: type: integer minimum: 0 description: >- Credit notes linked to this invoice, including soft-deleted ones. matched_invoice_count: type: integer minimum: 0 description: >- Invoices this credit note is matched to, including soft-deleted ones. required: - agreement_count - alert_count - linked_credit_note_count - matched_invoice_count required: - id - url - invoice_number - title - category - issued_date - due_date - created_at - updated_at - deleted_at - supplier - recipient - amounts - review - workflows - alerts - relationships ClaimRefund: type: object properties: id: type: string format: uuid amount: type: string currency_code: type: string comment: type: - string - 'null' credit_note_id: type: - string - 'null' format: uuid created_by_user_id: type: - string - 'null' created_at: type: string format: date-time updated_at: type: string format: date-time required: - id - amount - currency_code - comment - credit_note_id - created_by_user_id - created_at - updated_at InvoiceParty: type: object properties: id: type: - string - 'null' format: uuid description: The supplier or recipient in Watchdog. Null when unlinked. name: type: - string - 'null' description: The party's current name in Watchdog. Null when unlinked. invoiced_as: type: object properties: name: type: - string - 'null' organization_number: type: - string - 'null' required: - name - organization_number description: >- The party as printed on the invoice. Reassigning the party changes id, never this. required: - id - name - invoiced_as InvoiceAmounts: type: object properties: currency_code: type: - string - 'null' description: Currency of every amount on the invoice. excluding_vat: type: - string - 'null' maxLength: 100 pattern: ^-?\d+(?:\.\d+)?$ description: Invoice total excluding VAT. Null when unknown. example: '1250.00' including_vat: type: - string - 'null' maxLength: 100 pattern: ^-?\d+(?:\.\d+)?$ description: Invoice total including VAT. Null when unknown. example: '1250.00' valid: type: boolean readOnly: true description: >- Whether the amounts add up, within 1 currency unit. Says nothing about extraction accuracy or compliance. errors: type: array items: type: object properties: code: type: string enum: - missing_financial_inputs - line_calculation_mismatch - invoice_total_mismatch - invoice_subtotal_mismatch - category_amount_mismatch field: type: string message: type: string required: - code - field - message readOnly: true description: Why valid is false; field is the path of the failing field. required: - currency_code - excluding_vat - including_vat - valid - errors InvoiceReview: type: object properties: recommended: type: boolean description: >- True for unconfirmed low or medium extraction confidence, an unmatched credit note, or amounts that do not add up. extraction_confidence: type: string enum: - high - mid - low - unknown description: >- Confidence in the data extracted from a PDF invoice. unknown for XML, API-created and manually created invoices. confirmed: type: - object - 'null' properties: at: type: string format: date-time by_user_id: type: - string - 'null' required: - at - by_user_id description: True once a person has confirmed the extracted data. required: - recommended - extraction_confidence - confirmed readOnly: true InvoiceWorkflows: type: object properties: settled: type: boolean description: True when no step is pending or running. credit_note_matching: type: object properties: status: type: string enum: - pending - running - completed - failed - skipped - not_started run_id: type: - string - 'null' format: uuid description: >- The workflow run, at GET /v1/workflow-runs/{id}. Null when the step was skipped, has not started, or was started from an agreement. skip_reason: type: - string - 'null' enum: - credit_note - credit_note_matched - no_primary_document - no_agreements - null description: Why the step does not apply. Null unless status is skipped. required: - status - run_id - skip_reason agreement_matching: type: object properties: status: type: string enum: - pending - running - completed - failed - skipped - not_started run_id: type: - string - 'null' format: uuid description: >- The workflow run, at GET /v1/workflow-runs/{id}. Null when the step was skipped, has not started, or was started from an agreement. skip_reason: type: - string - 'null' enum: - credit_note - credit_note_matched - no_primary_document - no_agreements - null description: Why the step does not apply. Null unless status is skipped. required: - status - run_id - skip_reason alert_check: type: object properties: status: type: string enum: - pending - running - completed - failed - skipped - not_started run_id: type: - string - 'null' format: uuid description: >- The workflow run, at GET /v1/workflow-runs/{id}. Null when the step was skipped, has not started, or was started from an agreement. skip_reason: type: - string - 'null' enum: - credit_note - credit_note_matched - no_primary_document - no_agreements - null description: Why the step does not apply. Null unless status is skipped. required: - status - run_id - skip_reason required: - settled - credit_note_matching - agreement_matching - alert_check description: >- Processing that follows import, such as matching and compliance checks. Poll until settled, then read alerts. InvoiceAlerts: type: object properties: status: type: string enum: - credited - checking - has_issues - clean - not_checked description: >- Overall alert status: credited (covered by credit notes), checking (a check is running; results may change), has_issues (open alerts), clean (checked, no open alerts), or not_checked. check_status: type: string enum: - not_checkable - checking - not_checked - completed - incomplete description: >- How complete the checks are: completed (every matched agreement checked), incomplete (some unchecked, failed or cancelled), checking, not_checked, or not_checkable (credit notes, invoices with a matched credit note, invoices without a document). invoice_changed: type: boolean description: >- The invoice fingerprint differs from a completed check in scope. False when either fingerprint is unknown; agreement changes and alert actions do not affect this flag. counts: type: object properties: pending: type: object properties: credited: type: integer minimum: 0 uncredited: type: integer minimum: 0 required: - credited - uncredited accepted: type: object properties: credited: type: integer minimum: 0 uncredited: type: integer minimum: 0 required: - credited - uncredited dismissed: type: object properties: credited: type: integer minimum: 0 uncredited: type: integer minimum: 0 required: - credited - uncredited required: - pending - accepted - dismissed description: Alerts by verdict and credit, including dismissed and outdated ones. agreements: type: object properties: total: type: integer minimum: 0 description: Currently matched agreements in scope. checked: type: integer minimum: 0 description: Matched agreements in scope with a completed check. outdated: type: integer minimum: 0 description: >- Completed checks made against an earlier version of the agreement or invoice. required: - total - checked - outdated description: The matched agreements the checks cover. scope: type: object properties: type: type: string enum: - invoice - selected_agreements description: >- invoice covers all checks and alerts; selected_agreements covers only the selected agreements. agreement_ids: type: - array - 'null' items: type: string format: uuid maxItems: 50 description: The selected agreements; null for the invoice scope. required: - type - agreement_ids description: The scope of counts and agreements. required: - status - check_status - invoice_changed - counts - agreements - scope securitySchemes: ApiKeyBearer: type: http scheme: bearer description: >- 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). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.