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

# Get debtor

> The reusable debtors of your company.

List, retrieve, create, and PATCH. A supplied owned collection
(addresses, bank accounts, communication channels, legal
representatives) replaces that collection completely; omitted
collections stay unchanged. A case's debtor is the case's own snapshot
(published as `MandateDebtor` without an id) and is not a reusable
debtor: it is neither listed nor readable here.



## OpenAPI

````yaml /api-docs/case-management-api/openapi.json get /v2/debtors/{id}/
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/debtors/{id}/:
    get:
      tags:
        - Debtors
      summary: Get debtor
      description: |-
        The reusable debtors of your company.

        List, retrieve, create, and PATCH. A supplied owned collection
        (addresses, bank accounts, communication channels, legal
        representatives) replaces that collection completely; omitted
        collections stay unchanged. A case's debtor is the case's own snapshot
        (published as `MandateDebtor` without an id) and is not a reusable
        debtor: it is neither listed nor readable here.
      operationId: get-debtor
      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: UUID of the debtor in this request.
          in: path
          name: id
          required: true
          schema:
            format: uuid
            type: string
        - description: >-
            Return 304 with an empty body when the current `ETag` matches one of
            the supplied validators (or `*`).
          in: header
          name: If-None-Match
          required: false
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DebtorDetail'
          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
            ETag:
              description: >-
                Strong validator of this representation. Send it back as
                `If-None-Match` to skip an unchanged re-read (304) or as
                `If-Match` on PATCH/PUT/DELETE to fail with 412 when the
                resource changed.
              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
        '304':
          description: 'Not modified: the `If-None-Match` validator still matches.'
          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:
    DebtorDetail:
      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
        addresses:
          description: >-
            Postal addresses associated with the debtor. API submissions are
            limited to 5 entries.
          items:
            $ref: '#/components/schemas/AddressRead'
          readOnly: true
          type: array
        bank_accounts:
          description: >-
            Known bank accounts belonging to the debtor. API submissions are
            limited to 10 entries.
          items:
            $ref: '#/components/schemas/BankAccountRead'
          readOnly: true
          type: array
        communication_channels:
          description: >-
            Email addresses and telephone numbers for the debtor. API
            submissions are limited to 10 entries.
          items:
            $ref: '#/components/schemas/CommunicationChannelRead'
          readOnly: true
          type: array
        created_at:
          description: Time at which the debtor was created.
          format: date-time
          readOnly: true
          type: string
        events:
          description: Stored contextual events associated with this resource.
          items:
            $ref: '#/components/schemas/LegacyEventRead'
          readOnly: true
          type: array
        id:
          description: Stable identifier of this debtor.
          format: uuid
          readOnly: true
          type: string
        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
        legal_representatives:
          description: >-
            People or organizations legally representing the debtor. API
            submissions are limited to 10 entries.
          items:
            $ref: '#/components/schemas/LegalRepresentativeRead'
          readOnly: true
          type: array
        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
        updated_at:
          description: Time at which the debtor was last updated.
          format: date-time
          readOnly: true
          type: string
        your_reference:
          description: Your reference for this debtor.
          nullable: true
          readOnly: true
          type: string
      required:
        - acting_as
        - addresses
        - bank_accounts
        - communication_channels
        - created_at
        - events
        - id
        - legal_form
        - legal_representatives
        - metadata
        - organization
        - person
        - updated_at
        - your_reference
      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
    ActingAsEnum:
      description: |-
        * `consumer` - consumer
        * `business` - business
      enum:
        - consumer
        - business
      type: string
    AddressRead:
      properties:
        city:
          description: City or locality of the address.
          readOnly: true
          type: string
        country:
          description: Country as a two-letter ISO 3166-1 code.
          readOnly: true
          type: string
        id:
          description: Stable identifier of this address.
          format: uuid
          readOnly: true
          type: string
        postal_code:
          description: Postal code of the address.
          readOnly: true
          type: string
        primary:
          description: Whether this is the debtor's primary postal address.
          readOnly: true
          type: boolean
        street:
          description: Street and house number.
          readOnly: true
          type: string
      required:
        - city
        - country
        - id
        - postal_code
        - primary
        - street
      type: object
    BankAccountRead:
      properties:
        account_holder:
          description: Name of the bank-account holder.
          readOnly: true
          type: string
        bic:
          description: BIC/SWIFT code of the bank account.
          nullable: true
          readOnly: true
          type: string
        iban:
          description: IBAN of the debtor's bank account.
          readOnly: true
          type: string
        id:
          description: Stable identifier of this bank account.
          format: uuid
          readOnly: true
          type: string
      required:
        - account_holder
        - bic
        - iban
        - id
      type: object
    CommunicationChannelRead:
      properties:
        id:
          description: Stable identifier of this communication channel.
          format: uuid
          readOnly: true
          type: string
        type:
          description: Kind of contact channel.
          readOnly: true
          type: string
        value:
          description: Email address or telephone number for the selected channel.
          readOnly: true
          type: string
      required:
        - id
        - type
        - value
      type: object
    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
    LegalRepresentativeRead:
      properties:
        id:
          description: Stable identifier of this legal representative.
          format: uuid
          readOnly: true
          type: string
        legal_form:
          description: Legal form of an organization representative.
          nullable: true
          readOnly: true
          type: string
        legal_representatives:
          description: >-
            Second-level people or organizations legally representing this
            representative. API submissions are limited to 10 entries at the
            second and final representative level.
          items:
            $ref: '#/components/schemas/LegalRepresentativeLevelTwoRead'
          readOnly: true
          type: array
        organization:
          allOf:
            - $ref: '#/components/schemas/OrganizationRead'
          description: Organization identity of the representative.
          nullable: true
          readOnly: true
        person:
          allOf:
            - $ref: '#/components/schemas/PersonRead'
          description: Natural-person identity of the representative.
          nullable: true
          readOnly: true
        role:
          allOf:
            - $ref: '#/components/schemas/RoleEnum'
          description: Legal or organizational role of the representative.
          readOnly: true
      required:
        - id
        - legal_form
        - legal_representatives
        - organization
        - person
        - role
      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
    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
    LegalRepresentativeLevelTwoRead:
      properties:
        id:
          description: Stable identifier of this legal representative.
          format: uuid
          readOnly: true
          type: string
        legal_form:
          description: Legal form of an organization representative.
          nullable: true
          readOnly: true
          type: string
        organization:
          allOf:
            - $ref: '#/components/schemas/OrganizationRead'
          description: Organization identity of the representative.
          nullable: true
          readOnly: true
        person:
          allOf:
            - $ref: '#/components/schemas/PersonRead'
          description: Natural-person identity of the representative.
          nullable: true
          readOnly: true
        role:
          allOf:
            - $ref: '#/components/schemas/RoleEnum'
          description: Legal or organizational role of the representative.
          readOnly: true
      required:
        - id
        - legal_form
        - organization
        - person
        - role
      type: object
    RoleEnum:
      enum:
        - managing_director
        - director
        - board_member
        - chairperson
        - general_partner
        - shareholder
        - owner
        - authorized_signatory
        - partner
        - legal_guardian
        - other
      type: string
    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.