> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paywise.de/llms.txt
> Use this file to discover all available pages before exploring further.

# List statement cases

> Page through the accepted cases included in one statement.

Same rows as the mandates array of the statement detail, with
limit/offset pagination and filters on the case and claim references.



## OpenAPI

````yaml /api-docs/case-management-api/openapi.json get /v2/statements/{id}/mandates/
openapi: 3.0.3
info:
  description: >-
    Submit orders and manage their complete lifecycle through the current API at
    the `/v2/` HTTP path.
  title: paywise Case Management API
  version: current
servers:
  - description: Production environment
    url: https://api.paywise.de
  - description: Sandbox environment
    url: https://api-sandbox.paywise.de
security: []
tags:
  - description: Submit orders and manage them until acceptance.
    name: Orders
  - description: Stable claim resources and their current relationships.
    name: Claims
  - description: 'Accepted cases: state, published history and documents.'
    name: Mandates
  - description: Debtor master data reused across orders.
    name: Debtors
  - description: Payments reported by you and booked by paywise.
    name: Payments
  - description: Files attached to claims and other resources.
    name: Documents
  - description: Collective statements (Sammelabrechnungen).
    name: Statements
  - description: Per-case statements (Aktenabrechnungen).
    name: Single mandate statements
  - description: Webhook endpoints and their signing secrets.
    name: Webhooks
  - description: Delivery log and redelivery of webhook events.
    name: Webhook deliveries
  - description: Ordered feed of the events webhooks deliver.
    name: Events
  - description: Reference catalog of legal forms.
    name: Legal forms
  - description: The authenticated credential and its context.
    name: Info
  - description: Rate-limit headroom of the credential.
    name: Usage
  - description: Availability of the API.
    name: Health
externalDocs:
  url: https://docs.paywise.de/api-docs/case-management-api/introduction
paths:
  /v2/statements/{id}/mandates/:
    get:
      tags:
        - Statements
      summary: List statement cases
      description: |-
        Page through the accepted cases included in one statement.

        Same rows as the mandates array of the statement detail, with
        limit/offset pagination and filters on the case and claim references.
      operationId: list-statement-cases
      parameters:
        - description: >-
            Required when a Partner key calls the Case Management API; rejected
            for direct Case keys. Contains the entitled paywise company UUID.
          in: header
          name: X-On-Behalf-Of-Company
          schema:
            format: uuid
            type: string
        - description: >-
            Case-insensitive substring of any claim document reference in the
            case, usually your invoice number.
          in: query
          name: document_reference
          schema:
            type: string
        - description: UUID of the statement in this request.
          in: path
          name: id
          required: true
          schema:
            format: uuid
            type: string
        - description: Number of results to return (maximum 100).
          in: query
          name: limit
          schema:
            default: 10
            maximum: 100
            minimum: 1
            type: integer
        - description: Zero-based result offset.
          in: query
          name: offset
          schema:
            default: 0
            minimum: 0
            type: integer
        - description: Case-insensitive substring of the paywise case reference.
          in: query
          name: reference_number
          schema:
            type: string
        - description: >-
            Case-insensitive substring of any claim reference in the case, such
            as your order or contract reference.
          in: query
          name: your_reference
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatementMandateRowPage'
          description: ''
          headers:
            Cache-Control:
              description: >-
                Cacheability directive. Authenticated responses use `private,
                no-store`; the legal-form catalog may use `private,
                max-age=86400`.
              schema:
                type: string
            X-Paywise-Environment:
              description: Environment that produced the response.
              schema:
                enum:
                  - production
                  - sandbox
                type: string
            X-Paywise-Request-Id:
              description: >-
                Fresh server-assigned correlation id for this response.
                Caller-provided request ids are ignored.
              schema:
                format: uuid
                type: string
        '400':
          content:
            application/json:
              examples:
                validation-error:
                  value:
                    code: validation_error
                    detail: The request contains invalid data.
                    errors:
                      - code: invalid
                        field: claims[0].due_date
                        message: Due date must not precede the document date.
              schema:
                $ref: '#/components/schemas/Error'
          description: Standard error response.
          headers:
            Cache-Control:
              description: >-
                Cacheability directive. Authenticated responses use `private,
                no-store`; the legal-form catalog may use `private,
                max-age=86400`.
              schema:
                type: string
            X-Paywise-Environment:
              description: Environment that produced the response.
              schema:
                enum:
                  - production
                  - sandbox
                type: string
            X-Paywise-Request-Id:
              description: >-
                Fresh server-assigned correlation id for this response.
                Caller-provided request ids are ignored.
              schema:
                format: uuid
                type: string
        '401':
          content:
            application/json:
              examples:
                authentication-error:
                  value:
                    code: not_authenticated
                    detail: Authentication credentials were not provided.
              schema:
                $ref: '#/components/schemas/Error'
          description: Standard error response.
          headers:
            Cache-Control:
              description: >-
                Cacheability directive. Authenticated responses use `private,
                no-store`; the legal-form catalog may use `private,
                max-age=86400`.
              schema:
                type: string
            X-Paywise-Environment:
              description: Environment that produced the response.
              schema:
                enum:
                  - production
                  - sandbox
                type: string
            X-Paywise-Request-Id:
              description: >-
                Fresh server-assigned correlation id for this response.
                Caller-provided request ids are ignored.
              schema:
                format: uuid
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Standard error response.
          headers:
            Cache-Control:
              description: >-
                Cacheability directive. Authenticated responses use `private,
                no-store`; the legal-form catalog may use `private,
                max-age=86400`.
              schema:
                type: string
            X-Paywise-Environment:
              description: Environment that produced the response.
              schema:
                enum:
                  - production
                  - sandbox
                type: string
            X-Paywise-Request-Id:
              description: >-
                Fresh server-assigned correlation id for this response.
                Caller-provided request ids are ignored.
              schema:
                format: uuid
                type: string
        '404':
          content:
            application/json:
              examples:
                not-found-error:
                  value:
                    code: not_found
                    detail: The requested resource was not found.
              schema:
                $ref: '#/components/schemas/Error'
          description: Standard error response.
          headers:
            Cache-Control:
              description: >-
                Cacheability directive. Authenticated responses use `private,
                no-store`; the legal-form catalog may use `private,
                max-age=86400`.
              schema:
                type: string
            X-Paywise-Environment:
              description: Environment that produced the response.
              schema:
                enum:
                  - production
                  - sandbox
                type: string
            X-Paywise-Request-Id:
              description: >-
                Fresh server-assigned correlation id for this response.
                Caller-provided request ids are ignored.
              schema:
                format: uuid
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Standard error response.
          headers:
            Cache-Control:
              description: >-
                Cacheability directive. Authenticated responses use `private,
                no-store`; the legal-form catalog may use `private,
                max-age=86400`.
              schema:
                type: string
            Retry-After:
              description: Integer seconds to wait before retrying a throttled request.
              schema:
                minimum: 1
                type: integer
            X-Paywise-Environment:
              description: Environment that produced the response.
              schema:
                enum:
                  - production
                  - sandbox
                type: string
            X-Paywise-Request-Id:
              description: >-
                Fresh server-assigned correlation id for this response.
                Caller-provided request ids are ignored.
              schema:
                format: uuid
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Standard error response.
          headers:
            Cache-Control:
              description: >-
                Cacheability directive. Authenticated responses use `private,
                no-store`; the legal-form catalog may use `private,
                max-age=86400`.
              schema:
                type: string
            X-Paywise-Environment:
              description: Environment that produced the response.
              schema:
                enum:
                  - production
                  - sandbox
                type: string
            X-Paywise-Request-Id:
              description: >-
                Fresh server-assigned correlation id for this response.
                Caller-provided request ids are ignored.
              schema:
                format: uuid
                type: string
      security:
        - caseBearerAuth: []
        - partnerBearerAuth: []
components:
  schemas:
    StatementMandateRowPage:
      description: Limit/offset page of statement case rows.
      properties:
        count:
          description: Total number of matching case rows.
          readOnly: true
          type: integer
        next:
          description: URL for the next page, or null when this is the last page.
          format: uri
          nullable: true
          readOnly: true
          type: string
        previous:
          description: URL for the previous page, or null when this is the first page.
          format: uri
          nullable: true
          readOnly: true
          type: string
        results:
          description: Case rows returned for the requested page.
          items:
            $ref: '#/components/schemas/StatementMandateRow'
          readOnly: true
          type: array
      required:
        - count
        - next
        - previous
        - results
      type: object
    Error:
      properties:
        code:
          description: Machine-readable error category.
          type: string
        detail:
          description: Short human-readable summary of the error.
          type: string
        errors:
          description: Field-level validation errors, when applicable.
          items:
            $ref: '#/components/schemas/ErrorItem'
          type: array
      required:
        - detail
        - code
      type: object
    StatementMandateRow:
      properties:
        amount:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Current claim total of the linked main case, shared with its
            sub-cases; null when the case or its total is unavailable. This is a
            live case value, rather than a snapshot at the statement booking
            date.
          nullable: true
          readOnly: true
        closing:
          allOf:
            - $ref: '#/components/schemas/StatementClosing'
          description: Closing details when the accepted case ended in this statement.
          nullable: true
          readOnly: true
        cost_burden:
          description: Fees and expenses charged to you, grouped by VAT rate.
          items:
            $ref: '#/components/schemas/StatementCostBurden'
          readOnly: true
          type: array
        created_at:
          description: Time at which the accepted case was created.
          format: date-time
          readOnly: true
          type: string
        debtor:
          allOf:
            - $ref: '#/components/schemas/MandateDebtor'
          description: Debtor associated with the accepted case.
          nullable: true
          readOnly: true
        id:
          description: Identifier of the accepted case included in the statement.
          format: uuid
          readOnly: true
          type: string
        reference_number:
          description: paywise case-file reference number.
          nullable: true
          readOnly: true
          type: string
        related_statements:
          description: >-
            Other published statements that also include this accepted case,
            newest first. Empty when the case appears in no other statement.
          items:
            $ref: '#/components/schemas/RelatedStatement'
          readOnly: true
          type: array
        state:
          allOf:
            - $ref: '#/components/schemas/MandateState'
          description: Current legal, processing, and payment states of the case.
          nullable: true
          readOnly: true
        third_party_money:
          description: Debtor-payment allocations grouped by VAT rate.
          items:
            $ref: '#/components/schemas/StatementThirdPartyMoney'
          readOnly: true
          type: array
      required:
        - amount
        - closing
        - cost_burden
        - created_at
        - debtor
        - id
        - reference_number
        - related_statements
        - state
        - third_party_money
      type: object
    ErrorItem:
      properties:
        code:
          description: Machine-readable field error code.
          type: string
        field:
          description: >-
            Path to the field that caused the error, using dots for objects and
            brackets for list indexes, for example `claims[0].amount`; null for
            an error without a field path.
          nullable: true
          type: string
        message:
          description: Human-readable explanation of the field error.
          type: string
      required:
        - field
        - code
        - message
      type: object
    StatementAmount:
      properties:
        currency:
          description: Currency of the amount.
          readOnly: true
          type: string
        value:
          description: Monetary value expressed with two decimal places.
          format: decimal
          pattern: ^-?\d{0,14}(?:\.\d{0,2})?$
          readOnly: true
          type: string
      required:
        - currency
        - value
      type: object
    StatementClosing:
      properties:
        accepted_main_claim_amount:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: Principal amount accepted when the case was closed.
          nullable: true
          readOnly: true
        closing_code:
          allOf:
            - $ref: '#/components/schemas/ClosingCodeEnum'
          description: |-
            Machine-readable closing reason code.

            * `IP01` - Vollzahlung
            * `IP02` - Teilzahlung
            * `IP03` - vor Bearbeitung bezahlt
            * `IP04` - Vergleichszahlung
            * `IPU1` - Vollzahlung (Unterakte)
            * `IPU2` - Teilzahlung (Unterakte)
            * `IPU3` - vor Bearbeitung bezahlt (Unterakte)
            * `IPU4` - Vergleichszahlung (Unterakte)
            * `IN01` - Akte storniert
            * `IN010` - Akte storniert - keine Kostenbelastung Honorar
            * `IN011` - Akte geschlossen: Negative SCHUFA-Auskunft
            * `IN012` - Akte storniert: Nicht eingezahlter GMV-Vorschuss
            * `IN013` - Akte storniert: Nicht eingezahlter ZV-Vorschuss
            * `IN014` - Akte storniert: Nicht beantwortete Rückfrage
            * `IN015` - Akte geschlossen: Mangels zustellfähiger Anschrift
            * `IN016` - Akte geschlossen: Schuldner verstorben
            * `IN017` - Akte geschlossen: Bestritten
            * `IN018` - Akte storniert: Zahlung vor Übernahme
            * `IN02` - Kunde wünscht Abschluss
            * `IN020` - Kunde wünscht Abschluss - keine Kostenbelastung
            * `IN03` - Abschluss wegen EV
            * `IN04` - Abschluss wegen Insolvenz
            * `IN05` - Schuldner verstorben
            * `IN06` - Erfolglos
            * `INO7` - Aktensperre
            * `IN08` - Aufhebung Aktensperre
            * `INU1` - Unterakte storniert
            * `INU2` - Kunde wünscht Abschluss (Unterakte)
            * `INU3` - Abschluss wegen EV (Unterakte)
            * `INU4` - Abschluss wegen Insolvenz (Unterakte)
            * `INU5` - Schuldner verstorben (Unterakte)
            * `INU6` - Erfolglos (Unterakte)
            * `IÜ01` - Überwachung Sonstiges
            * `IÜ02` - Überwachung Abgabe EV
            * `IÜ03` - Überwachung Insolvenz
            * `IÜU1` - Überwachung Sonstiges (Unterakte)
            * `IÜU2` - Überwachung Abgabe EV (Unterakte)
            * `IÜU3` - Überwachung Insolvenz (Unterakte)
          nullable: true
          readOnly: true
        closing_date:
          description: Date on which the case was closed.
          format: date
          nullable: true
          readOnly: true
          type: string
        closing_description:
          description: Human-readable explanation of the closing reason.
          nullable: true
          readOnly: true
          type: string
        closing_type:
          allOf:
            - $ref: '#/components/schemas/ClosingTypeEnum'
          description: >-
            Business category of the case closing.


            * `positive` - Positiv

            * `negative` - Negativ

            * `transition_to_longtime_monitoring` - Übergang ins
            Überwachungsverfahren
          nullable: true
          readOnly: true
        remaining_main_claim_amount:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: Principal amount still open when the case was closed.
          nullable: true
          readOnly: true
      required:
        - accepted_main_claim_amount
        - closing_code
        - closing_date
        - closing_description
        - closing_type
        - remaining_main_claim_amount
      type: object
    StatementCostBurden:
      properties:
        fee:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: Collection fee charged to you.
          nullable: true
          readOnly: true
        fee_vat:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: VAT on the collection fee charged to you.
          nullable: true
          readOnly: true
        litigation_taxable_expenses:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: Taxable litigation expenses charged to you.
          nullable: true
          readOnly: true
        litigation_taxable_expenses_vat:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: VAT on taxable litigation expenses charged to you.
          nullable: true
          readOnly: true
        litigation_taxfree_expenses:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: Tax-free litigation expenses charged to you.
          nullable: true
          readOnly: true
        tax_free_expenses:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: Tax-free expenses charged to you.
          nullable: true
          readOnly: true
        taxable_expenses:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: Taxable expenses charged to you.
          nullable: true
          readOnly: true
        taxable_expenses_vat:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: VAT on taxable expenses charged to you.
          nullable: true
          readOnly: true
        total_amount:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: Total amount charged to you for this VAT rate.
          nullable: true
          readOnly: true
        vat_rate:
          description: VAT percentage applied to this cost burden, e.g. 19.00 for 19%.
          format: decimal
          pattern: ^-?\d{0,3}(?:\.\d{0,2})?$
          readOnly: true
          type: string
      required:
        - fee
        - fee_vat
        - litigation_taxable_expenses
        - litigation_taxable_expenses_vat
        - litigation_taxfree_expenses
        - tax_free_expenses
        - taxable_expenses
        - taxable_expenses_vat
        - total_amount
        - vat_rate
      type: object
    MandateDebtor:
      description: Immutable debtor snapshot embedded in accepted-case resources.
      properties:
        acting_as:
          allOf:
            - $ref: '#/components/schemas/ActingAsEnum'
          description: >-
            Whether the debtor incurred the obligation as a consumer or in a
            business capacity.


            * `consumer` - consumer

            * `business` - business
          readOnly: true
        events:
          description: Stored contextual events associated with this resource.
          items:
            $ref: '#/components/schemas/LegacyEventRead'
          readOnly: true
          type: array
        legal_form:
          description: >-
            Permanent public legal-form code; look up its label and
            representation rules with GET /v2/legal-forms/. Null for consumers.
          nullable: true
          readOnly: true
          type: string
        metadata:
          description: Stored metadata entries; duplicate types remain separate entries.
          items:
            $ref: '#/components/schemas/LegacyMetadataRead'
          readOnly: true
          type: array
        organization:
          allOf:
            - $ref: '#/components/schemas/OrganizationRead'
          description: Organization identity for a business debtor.
          nullable: true
          readOnly: true
        person:
          allOf:
            - $ref: '#/components/schemas/PersonRead'
          description: Natural-person identity for a consumer or sole proprietor.
          nullable: true
          readOnly: true
        your_reference:
          description: Your reference for this debtor.
          nullable: true
          readOnly: true
          type: string
      required:
        - acting_as
        - events
        - legal_form
        - metadata
        - organization
        - person
        - your_reference
      type: object
    RelatedStatement:
      description: Reference to another statement that contains the same accepted case.
      properties:
        booking_date:
          description: Date on which the related statement was booked.
          format: date
          nullable: true
          readOnly: true
          type: string
        clearing_no:
          description: Clearing number of the related statement.
          nullable: true
          readOnly: true
          type: string
        id:
          description: Identifier of the related statement.
          format: uuid
          readOnly: true
          type: string
        period_end:
          description: End of the period covered by the related statement.
          format: date
          nullable: true
          readOnly: true
          type: string
        period_start:
          description: Start of the period covered by the related statement.
          format: date
          nullable: true
          readOnly: true
          type: string
      required:
        - booking_date
        - clearing_no
        - id
        - period_end
        - period_start
      type: object
    MandateState:
      properties:
        legal_stage:
          allOf:
            - $ref: '#/components/schemas/MandateStateValue'
          description: Current legal collection stage.
          readOnly: true
        payment:
          allOf:
            - $ref: '#/components/schemas/MandateStateValue'
          description: Current payment or settlement state.
          readOnly: true
        processing:
          allOf:
            - $ref: '#/components/schemas/MandateStateValue'
          description: Current operational processing state.
          readOnly: true
      required:
        - legal_stage
        - payment
        - processing
      type: object
    StatementThirdPartyMoney:
      properties:
        extraordinary_payouts_to_client:
          allOf:
            - $ref: '#/components/schemas/ExtraordinaryPayoutsToClient'
          description: Allocation of extraordinary payouts made to you.
          nullable: true
          readOnly: true
        payments_to_client:
          allOf:
            - $ref: '#/components/schemas/PaymentsToClient'
          description: Allocation of debtor payments made directly to you.
          nullable: true
          readOnly: true
        payments_to_dca:
          allOf:
            - $ref: '#/components/schemas/PaymentsToDCA'
          description: Allocation of debtor payments received by paywise.
          nullable: true
          readOnly: true
        total_payments:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: Total debtor payments received by paywise or directly by you.
          nullable: true
          readOnly: true
        vat_rate:
          description: >-
            VAT percentage applied to this payment allocation, e.g. 19.00 for
            19%.
          format: decimal
          pattern: ^-?\d{0,3}(?:\.\d{0,2})?$
          readOnly: true
          type: string
      required:
        - extraordinary_payouts_to_client
        - payments_to_client
        - payments_to_dca
        - total_payments
        - vat_rate
      type: object
    ClosingCodeEnum:
      description: |-
        * `IP01` - Vollzahlung
        * `IP02` - Teilzahlung
        * `IP03` - vor Bearbeitung bezahlt
        * `IP04` - Vergleichszahlung
        * `IPU1` - Vollzahlung (Unterakte)
        * `IPU2` - Teilzahlung (Unterakte)
        * `IPU3` - vor Bearbeitung bezahlt (Unterakte)
        * `IPU4` - Vergleichszahlung (Unterakte)
        * `IN01` - Akte storniert
        * `IN010` - Akte storniert - keine Kostenbelastung Honorar
        * `IN011` - Akte geschlossen: Negative SCHUFA-Auskunft
        * `IN012` - Akte storniert: Nicht eingezahlter GMV-Vorschuss
        * `IN013` - Akte storniert: Nicht eingezahlter ZV-Vorschuss
        * `IN014` - Akte storniert: Nicht beantwortete Rückfrage
        * `IN015` - Akte geschlossen: Mangels zustellfähiger Anschrift
        * `IN016` - Akte geschlossen: Schuldner verstorben
        * `IN017` - Akte geschlossen: Bestritten
        * `IN018` - Akte storniert: Zahlung vor Übernahme
        * `IN02` - Kunde wünscht Abschluss
        * `IN020` - Kunde wünscht Abschluss - keine Kostenbelastung
        * `IN03` - Abschluss wegen EV
        * `IN04` - Abschluss wegen Insolvenz
        * `IN05` - Schuldner verstorben
        * `IN06` - Erfolglos
        * `INO7` - Aktensperre
        * `IN08` - Aufhebung Aktensperre
        * `INU1` - Unterakte storniert
        * `INU2` - Kunde wünscht Abschluss (Unterakte)
        * `INU3` - Abschluss wegen EV (Unterakte)
        * `INU4` - Abschluss wegen Insolvenz (Unterakte)
        * `INU5` - Schuldner verstorben (Unterakte)
        * `INU6` - Erfolglos (Unterakte)
        * `IÜ01` - Überwachung Sonstiges
        * `IÜ02` - Überwachung Abgabe EV
        * `IÜ03` - Überwachung Insolvenz
        * `IÜU1` - Überwachung Sonstiges (Unterakte)
        * `IÜU2` - Überwachung Abgabe EV (Unterakte)
        * `IÜU3` - Überwachung Insolvenz (Unterakte)
      enum:
        - IP01
        - IP02
        - IP03
        - IP04
        - IPU1
        - IPU2
        - IPU3
        - IPU4
        - IN01
        - IN010
        - IN011
        - IN012
        - IN013
        - IN014
        - IN015
        - IN016
        - IN017
        - IN018
        - IN02
        - IN020
        - IN03
        - IN04
        - IN05
        - IN06
        - INO7
        - IN08
        - INU1
        - INU2
        - INU3
        - INU4
        - INU5
        - INU6
        - IÜ01
        - IÜ02
        - IÜ03
        - IÜU1
        - IÜU2
        - IÜU3
      type: string
    ClosingTypeEnum:
      description: >-
        * `positive` - Positiv

        * `negative` - Negativ

        * `transition_to_longtime_monitoring` - Übergang ins
        Überwachungsverfahren
      enum:
        - positive
        - negative
        - transition_to_longtime_monitoring
      type: string
    ActingAsEnum:
      description: |-
        * `consumer` - consumer
        * `business` - business
      enum:
        - consumer
        - business
      type: string
    LegacyEventRead:
      description: Stored events may likewise use retired or internal type values.
      properties:
        description:
          description: Optional description of the event.
          nullable: true
          readOnly: true
          type: string
        location:
          description: Optional location associated with the event.
          nullable: true
          readOnly: true
          type: string
        occurence:
          description: >-
            Time at which the event occurred; the historical field spelling is
            intentional.
          format: date-time
          readOnly: true
          type: string
        title:
          description: Human-readable title of the event.
          readOnly: true
          type: string
        type:
          description: >-
            Stored event type; historical values may be outside today's input
            enum.
          readOnly: true
          type: string
        your_reference:
          description: Your optional reference for the event.
          nullable: true
          readOnly: true
          type: string
      required:
        - description
        - location
        - occurence
        - title
        - type
        - your_reference
      type: object
    LegacyMetadataRead:
      description: Stored types may predate today's resource-specific input choices.
      properties:
        type:
          description: >-
            Stored metadata type; historical values may be outside today's input
            enum.
          readOnly: true
          type: string
        value:
          description: Stored metadata value.
          readOnly: true
          type: string
      required:
        - type
        - value
      type: object
    OrganizationRead:
      properties:
        commercial_register:
          description: Register court or authority holding the registration.
          nullable: true
          readOnly: true
          type: string
        commercial_registration_number:
          description: Commercial, association, or partnership register number.
          nullable: true
          readOnly: true
          type: string
        name:
          description: Registered or trading name of the organization.
          readOnly: true
          type: string
      required:
        - commercial_register
        - commercial_registration_number
        - name
      type: object
    PersonRead:
      properties:
        birth_date:
          description: Date of birth used to identify the natural person.
          format: date
          nullable: true
          readOnly: true
          type: string
        first_name:
          description: Given name of the natural person.
          readOnly: true
          type: string
        last_name:
          description: Family name of the natural person.
          readOnly: true
          type: string
        salutation:
          allOf:
            - $ref: '#/components/schemas/SalutationEnum'
          description: >-
            Salutation of the natural person; null if no supported salutation is
            stored.
          nullable: true
          readOnly: true
      required:
        - birth_date
        - first_name
        - last_name
        - salutation
      type: object
    MandateStateValue:
      description: Stable machine code plus an i18n-ready label key and current label.
      properties:
        code:
          description: >-
            Stable machine-readable state code; an empty string when that state
            has not been set.
          readOnly: true
          type: string
        label:
          description: >-
            Current human-readable state label; an empty string when its code is
            unset.
          readOnly: true
          type: string
        label_key:
          description: >-
            Stable translation key for the state; an empty string when its code
            is unset.
          readOnly: true
          type: string
      required:
        - code
        - label
        - label_key
      type: object
    ExtraordinaryPayoutsToClient:
      properties:
        allocation_to_client_costs:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to your costs from extraordinary payouts made to
            you.
          nullable: true
          readOnly: true
        allocation_to_client_expenses:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to your expenses from extraordinary payouts made to
            you.
          nullable: true
          readOnly: true
        allocation_to_default_interest:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to default interest from extraordinary payouts made
            to you.
          nullable: true
          readOnly: true
        allocation_to_fee:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to the collection fee from extraordinary payouts
            made to you.
          nullable: true
          readOnly: true
        allocation_to_fee_vat:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: Amount allocated to fee VAT from extraordinary payouts made to you.
          nullable: true
          readOnly: true
        allocation_to_main_claim:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to the principal claim from extraordinary payouts
            made to you.
          nullable: true
          readOnly: true
        allocation_to_overpayment:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to overpayment from extraordinary payouts made to
            you.
          nullable: true
          readOnly: true
        allocation_to_success_commission:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to the success commission from extraordinary
            payouts made to you.
          nullable: true
          readOnly: true
        allocation_to_success_commission_vat:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to success-commission VAT from extraordinary
            payouts made to you.
          nullable: true
          readOnly: true
        allocation_to_tax_free_expenses:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to paywise's tax-free expenses from extraordinary
            payouts made to you.
          nullable: true
          readOnly: true
        allocation_to_taxable_expenses:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to paywise's taxable expenses from extraordinary
            payouts made to you.
          nullable: true
          readOnly: true
        allocation_to_taxable_expenses_vat:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to VAT on taxable expenses from extraordinary
            payouts made to you.
          nullable: true
          readOnly: true
        payout:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: Resulting payout balance from extraordinary payouts made to you.
          nullable: true
          readOnly: true
        total_payments:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: Total extraordinary payouts made to you.
          nullable: true
          readOnly: true
      required:
        - allocation_to_client_costs
        - allocation_to_client_expenses
        - allocation_to_default_interest
        - allocation_to_fee
        - allocation_to_fee_vat
        - allocation_to_main_claim
        - allocation_to_overpayment
        - allocation_to_success_commission
        - allocation_to_success_commission_vat
        - allocation_to_tax_free_expenses
        - allocation_to_taxable_expenses
        - allocation_to_taxable_expenses_vat
        - payout
        - total_payments
      type: object
    PaymentsToClient:
      properties:
        allocation_to_client_costs:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to your costs from debtor payments made directly to
            you.
          nullable: true
          readOnly: true
        allocation_to_client_expenses:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to your expenses from debtor payments made directly
            to you.
          nullable: true
          readOnly: true
        allocation_to_default_interest:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to default interest from debtor payments made
            directly to you.
          nullable: true
          readOnly: true
        allocation_to_fee:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to the collection fee from debtor payments made
            directly to you.
          nullable: true
          readOnly: true
        allocation_to_fee_vat:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to fee VAT from debtor payments made directly to
            you.
          nullable: true
          readOnly: true
        allocation_to_main_claim:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to the principal claim from debtor payments made
            directly to you.
          nullable: true
          readOnly: true
        allocation_to_overpayment:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to overpayment from debtor payments made directly
            to you.
          nullable: true
          readOnly: true
        allocation_to_success_commission:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to the success commission from debtor payments made
            directly to you.
          nullable: true
          readOnly: true
        allocation_to_success_commission_vat:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to success-commission VAT from debtor payments made
            directly to you.
          nullable: true
          readOnly: true
        allocation_to_tax_free_expenses:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to paywise's tax-free expenses from debtor payments
            made directly to you.
          nullable: true
          readOnly: true
        allocation_to_taxable_expenses:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to paywise's taxable expenses from debtor payments
            made directly to you.
          nullable: true
          readOnly: true
        allocation_to_taxable_expenses_vat:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to VAT on taxable expenses from debtor payments
            made directly to you.
          nullable: true
          readOnly: true
        payout:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: Resulting payout balance from debtor payments made directly to you.
          nullable: true
          readOnly: true
        total_payments:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: Total debtor payments made directly to you.
          nullable: true
          readOnly: true
      required:
        - allocation_to_client_costs
        - allocation_to_client_expenses
        - allocation_to_default_interest
        - allocation_to_fee
        - allocation_to_fee_vat
        - allocation_to_main_claim
        - allocation_to_overpayment
        - allocation_to_success_commission
        - allocation_to_success_commission_vat
        - allocation_to_tax_free_expenses
        - allocation_to_taxable_expenses
        - allocation_to_taxable_expenses_vat
        - payout
        - total_payments
      type: object
    PaymentsToDCA:
      properties:
        allocation_to_client_costs:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to your costs from debtor payments received by
            paywise.
          nullable: true
          readOnly: true
        allocation_to_client_expenses:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to your expenses from debtor payments received by
            paywise.
          nullable: true
          readOnly: true
        allocation_to_default_interest:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to default interest from debtor payments received
            by paywise.
          nullable: true
          readOnly: true
        allocation_to_fee:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to the collection fee from debtor payments received
            by paywise.
          nullable: true
          readOnly: true
        allocation_to_fee_vat:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to fee VAT from debtor payments received by
            paywise.
          nullable: true
          readOnly: true
        allocation_to_main_claim:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to the principal claim from debtor payments
            received by paywise.
          nullable: true
          readOnly: true
        allocation_to_overpayment:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to overpayment from debtor payments received by
            paywise.
          nullable: true
          readOnly: true
        allocation_to_success_commission:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to the success commission from debtor payments
            received by paywise.
          nullable: true
          readOnly: true
        allocation_to_success_commission_vat:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to success-commission VAT from debtor payments
            received by paywise.
          nullable: true
          readOnly: true
        allocation_to_tax_free_expenses:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to paywise's tax-free expenses from debtor payments
            received by paywise.
          nullable: true
          readOnly: true
        allocation_to_taxable_expenses:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to paywise's taxable expenses from debtor payments
            received by paywise.
          nullable: true
          readOnly: true
        allocation_to_taxable_expenses_vat:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: >-
            Amount allocated to VAT on taxable expenses from debtor payments
            received by paywise.
          nullable: true
          readOnly: true
        payout:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: Resulting payout balance from debtor payments received by paywise.
          nullable: true
          readOnly: true
        total_payments:
          allOf:
            - $ref: '#/components/schemas/StatementAmount'
          description: Total debtor payments received by paywise.
          nullable: true
          readOnly: true
      required:
        - allocation_to_client_costs
        - allocation_to_client_expenses
        - allocation_to_default_interest
        - allocation_to_fee
        - allocation_to_fee_vat
        - allocation_to_main_claim
        - allocation_to_overpayment
        - allocation_to_success_commission
        - allocation_to_success_commission_vat
        - allocation_to_tax_free_expenses
        - allocation_to_taxable_expenses
        - allocation_to_taxable_expenses_vat
        - payout
        - total_payments
      type: object
    SalutationEnum:
      enum:
        - mr
        - ms
        - mx
      type: string
  securitySchemes:
    caseBearerAuth:
      description: >-
        Company-bound Case Management API key — the standard credential for this
        API.
      scheme: bearer
      type: http
    partnerBearerAuth:
      description: >-
        Partner API key acting for one entitled company; every Case request must
        then also carry the X-On-Behalf-Of-Company header.
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.