> ## 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.

# List purchase orders

> Lists purchase orders, standalone or linked to an agreement. Archived orders are left out unless archived=true. Totals exclude VAT.



## OpenAPI

````yaml /openapi.json get /v1/purchase-orders
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/purchase-orders:
    get:
      tags:
        - Purchase orders
      summary: List purchase orders
      description: >-
        Lists purchase orders, standalone or linked to an agreement. Archived
        orders are left out unless archived=true. Totals exclude VAT.
      operationId: listPurchaseOrders
      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.
        - name: fields
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
          style: form
          explode: false
          description: >-
            Return only these fields of each row; use dots for nested fields,
            such as approvers.user_id. id is always returned. Fields:
            company_id, id, number, title, status, awaiting_approval, approvers,
            archived, supplier, buyer, owner_user_id, agreement, currency_code,
            commitment_basis, totals, billing, revision, open_alert_count,
            valid_until, origin, source, from_import, created_at, updated_at.
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: Order number, the other system's number (source.number) or title.
          required: false
          description: Order number, the other system's number (source.number) or title.
          name: search
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 50
            description: Only orders linked to this other system (source.system).
          required: false
          description: Only orders linked to this other system (source.system).
          name: source_system
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            description: Only orders with these IDs in their other system (source.id).
          required: false
          description: Only orders with these IDs in their other system (source.id).
          style: form
          explode: false
          name: source_ids
          in: query
        - schema:
            type: array
            items:
              type: string
              enum:
                - draft
                - open
                - closed
                - cancelled
          required: false
          style: form
          explode: false
          name: statuses
          in: query
        - schema:
            type: boolean
            description: >-
              true lists only orders waiting for approval, false only the
              others.
          required: false
          description: true lists only orders waiting for approval, false only the others.
          name: awaiting_approval
          in: query
        - schema:
            type: array
            items:
              type: string
              format: uuid
          required: false
          style: form
          explode: false
          name: supplier_ids
          in: query
        - schema:
            type: array
            items:
              type: string
              format: uuid
            minItems: 1
            maxItems: 1000
            description: Only orders these workspace companies placed.
          required: false
          description: Only orders these workspace companies placed.
          style: form
          explode: false
          name: company_ids
          in: query
        - schema:
            type: array
            items:
              type: string
              format: uuid
            description: 'Recipient IDs: the legal entities that placed the orders.'
          required: false
          description: 'Recipient IDs: the legal entities that placed the orders.'
          style: form
          explode: false
          name: buyer_ids
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
              pattern: ^[A-Za-z0-9_-]+$
          required: false
          style: form
          explode: false
          name: owner_user_ids
          in: query
        - schema:
            type: string
            enum:
              - me
            description: >-
              me: orders the caller owns, and orders whose pending approval
              request asks the caller to approve, by name or through a team they
              are in.
          required: false
          description: >-
            me: orders the caller owns, and orders whose pending approval
            request asks the caller to approve, by name or through a team they
            are in.
          name: assigned
          in: query
        - schema:
            type: array
            items:
              type: string
          required: false
          style: form
          explode: false
          name: agreement_ids
          in: query
        - schema:
            type: boolean
            description: true lists only archived orders; by default they are left out.
          required: false
          description: true lists only archived orders; by default they are left out.
          name: archived
          in: query
        - schema:
            type: boolean
            description: >-
              true lists only orders with an accepted invoice
              (billing.linked_invoices above 0), false only those without.
          required: false
          description: >-
            true lists only orders with an accepted invoice
            (billing.linked_invoices above 0), false only those without.
          name: has_invoices
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 50
          required: false
          name: limit
          in: query
        - schema:
            type: string
            maxLength: 4096
          required: false
          name: cursor
          in: query
        - schema:
            type: string
            enum:
              - created_at
              - updated_at
              - number
              - supplier
              - buyer
              - company
              - status
              - commitment
              - checks
              - billed
            default: created_at
            description: >-
              company sorts by company name; checks by open_alert_count; billed
              by billing.billed over totals.commitment. Drafts sort last by
              checks and billed, as do orders without an accepted invoice or a
              commitment by billed.
          required: false
          description: >-
            company sorts by company name; checks by open_alert_count; billed by
            billing.billed over totals.commitment. Drafts sort last by checks
            and billed, as do orders without an accepted invoice or a commitment
            by billed.
          name: sort
          in: query
        - schema:
            type: string
            enum:
              - asc
              - desc
            default: desc
          required: false
          name: direction
          in: query
      responses:
        '200':
          description: A page of purchase orders; next_cursor is null at the end.
          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:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/PurchaseOrderSummary'
                    maxItems: 1000
                  next_cursor:
                    type:
                      - string
                      - 'null'
                required:
                  - data
                  - next_cursor
        '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:
              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
              schema:
                $ref: '#/components/schemas/Error_validation_error'
        '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:
              example:
                error:
                  code: invalid_token
                  message: The bearer token is missing or invalid.
                  request_id: req_example
              schema:
                $ref: '#/components/schemas/Error_invalid_token'
        '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:
              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
              schema:
                $ref: >-
                  #/components/schemas/Error_forbidden_token_disabled_organization_required_insufficient_role_mfa_required
        '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:
              example:
                error:
                  code: not_found
                  message: The resource does not exist in the current organization.
                  request_id: req_example
              schema:
                $ref: '#/components/schemas/Error_not_found'
        '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:
              example:
                error:
                  code: rate_limit_exceeded
                  message: >-
                    Too many requests. Wait for the Retry-After delay before
                    retrying.
                  request_id: req_example
              schema:
                $ref: '#/components/schemas/Error_rate_limit_exceeded'
        '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:
              example:
                error:
                  code: internal_error
                  message: >-
                    Unexpected server failure. Include the request ID when
                    contacting support.
                  request_id: req_example
              schema:
                $ref: '#/components/schemas/Error_internal_error'
        '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:
              example:
                error:
                  code: service_unavailable
                  message: >-
                    Temporarily unavailable. Retry after the Retry-After delay,
                    when provided.
                  request_id: req_example
              schema:
                $ref: '#/components/schemas/Error_service_unavailable'
      security:
        - ApiKeyBearer: []
components:
  schemas:
    PurchaseOrderSummary:
      type: object
      properties:
        company_id:
          type: string
          format: uuid
          description: >-
            The company that places the order. Its buyer is the company's own
            recipient, unless an imported order names another.
        id:
          type: string
          format: uuid
        number:
          type:
            - string
            - 'null'
        title:
          type:
            - string
            - 'null'
        status:
          type: string
          enum:
            - draft
            - open
            - closed
            - cancelled
          description: >-
            closed means closed for invoicing, set by a person; it is not
            derived from an ERP receipt status. Waiting for approval is not a
            status: see awaiting_approval.
        awaiting_approval:
          type: boolean
          description: >-
            The order has an approval request pending: a draft opens once
            approved; on an opened order it decides the proposed revision, while
            the current revision stays in force and can be sent and pushed.
        approvers:
          type: array
          items:
            type: object
            properties:
              user_id:
                type: string
                minLength: 1
                maxLength: 200
                pattern: ^[A-Za-z0-9_-]+$
              first_name:
                type:
                  - string
                  - 'null'
              last_name:
                type:
                  - string
                  - 'null'
              email:
                type:
                  - string
                  - 'null'
            required:
              - user_id
              - first_name
              - last_name
              - email
          description: >-
            The people the pending approval request waits for, in the order they
            were added; empty when none is pending. Teams it waits for are on
            approval.approver_teams. Who decided an earlier request is on
            approval.
        archived:
          type: boolean
        supplier:
          type:
            - object
            - 'null'
          properties:
            id:
              type: string
              format: uuid
            name:
              type: string
            organization_number:
              type:
                - string
                - 'null'
          required:
            - id
            - name
            - organization_number
        buyer:
          type:
            - object
            - 'null'
          properties:
            id:
              type: string
              format: uuid
            name:
              type: string
            organization_number:
              type:
                - string
                - 'null'
          required:
            - id
            - name
            - organization_number
          description: 'A recipient: the legal entity that placed the order.'
        owner_user_id:
          type:
            - string
            - 'null'
          minLength: 1
          maxLength: 200
          pattern: ^[A-Za-z0-9_-]+$
        agreement:
          type:
            - object
            - 'null'
          properties:
            id:
              type:
                - string
                - 'null'
              format: uuid
            title:
              type:
                - string
                - 'null'
            origin:
              type: string
              enum:
                - manual
                - automatic
            restricted:
              type: boolean
              description: >-
                True when the caller cannot see the agreement; id and title are
                then null.
          required:
            - id
            - title
            - origin
            - restricted
        currency_code:
          type:
            - string
            - 'null'
        commitment_basis:
          type: string
          enum:
            - lines
            - amount_limit
          description: >-
            lines: the order commits to its active lines. amount_limit: it
            commits to amount_limit for the scope in scope_description; its
            lines are price references.
        totals:
          type: object
          properties:
            lines_excluding_vat:
              type: string
              pattern: ^-?\d+(?:\.\d+)?$
              description: Active lines, excluding VAT.
            commitment:
              type:
                - string
                - 'null'
              pattern: ^-?\d+(?:\.\d+)?$
              description: >-
                Active lines for a lines order, amount_limit for an amount-limit
                order.
            expected:
              type:
                - string
                - 'null'
              pattern: ^-?\d+(?:\.\d+)?$
              description: >-
                What the order is expected to cost, excluding VAT: the budget,
                when set, while a lines order has no active lines; otherwise
                commitment.
          required:
            - lines_excluding_vat
            - commitment
            - expected
        billing:
          $ref: '#/components/schemas/PurchaseOrderBilling'
        revision:
          type:
            - integer
            - 'null'
          description: The current commercial revision; null for a draft.
        open_alert_count:
          type: integer
          minimum: 0
          description: >-
            Visible, live alerts from checking the order's invoices against it:
            neither dismissed, skipped nor credited.
        valid_until:
          type:
            - string
            - 'null'
        origin:
          type: string
          enum:
            - native
            - imported
          description: >-
            Where the order was born and is edited: `native` in Watchdog,
            `imported` in the ERP in `source`.
        source:
          $ref: '#/components/schemas/PurchaseOrderSource'
        from_import:
          type: boolean
          description: >-
            Drafted from documents through createPurchaseOrderImport; import has
            the details.
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - company_id
        - id
        - number
        - title
        - status
        - awaiting_approval
        - approvers
        - archived
        - supplier
        - buyer
        - owner_user_id
        - agreement
        - currency_code
        - commitment_basis
        - totals
        - billing
        - revision
        - open_alert_count
        - valid_until
        - origin
        - source
        - from_import
        - created_at
        - updated_at
    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_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
    PurchaseOrderBilling:
      type: object
      properties:
        linked_invoices:
          type: integer
          minimum: 0
        billed:
          type: string
        remaining:
          type:
            - string
            - 'null'
        excess:
          type:
            - string
            - 'null'
        authoritative:
          type: boolean
        coverage:
          type: object
          properties:
            pending_suggestions:
              type: integer
              minimum: 0
            unsupported_credits:
              type: integer
              minimum: 0
            incompatible_invoices:
              type: integer
              minimum: 0
            invalid_invoices:
              type: integer
              minimum: 0
            unassigned_invoices:
              type: integer
              minimum: 0
            reconciliation_pending:
              type: boolean
          required:
            - pending_suggestions
            - unsupported_credits
            - incompatible_invoices
            - invalid_invoices
            - unassigned_invoices
            - reconciliation_pending
        untied:
          type:
            - object
            - 'null'
          properties:
            lines:
              type: integer
              minimum: 0
            amount:
              type: string
          required:
            - lines
            - amount
      required:
        - linked_invoices
        - billed
        - remaining
        - excess
        - authoritative
        - coverage
        - untied
    PurchaseOrderSource:
      type:
        - object
        - 'null'
      properties:
        system:
          type: string
          description: >-
            The other system: an ERP, such as tripletex, or the name the creator
            gave.
        id:
          type: string
          description: That system's own ID for the order.
        number:
          type:
            - string
            - 'null'
          description: >-
            That system's number for the order; for a pushed order, the one the
            ERP assigned. Invoices citing it match the order.
        channel:
          type: string
          enum:
            - integration
            - api
          description: >-
            `integration`: a connection imports or pushes the order and keeps
            the fields below. `api`: linked when the order was created; nothing
            syncs it.
        status:
          type:
            - string
            - 'null'
          description: That system's own status for the order, as given.
        refreshed_at:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            When the ERP and Watchdog last agreed on the order; null while a
            push is unfinished.
        synced_revision:
          type:
            - integer
            - 'null'
          description: >-
            The revision the ERP verifiably holds; null while a push is
            unfinished.
        pending:
          type: boolean
          description: >-
            A native order's current revision is not in the ERP yet: never
            pushed, or amended since.
      required:
        - system
        - id
        - number
        - channel
        - status
        - refreshed_at
        - synced_revision
        - pending
      description: >-
        The order's ERP. An imported order's terms, lines and cancellation
        change there and the next sync brings them in; a native order is pushed
        there and its copy follows Watchdog.
  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.