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

# Submit request to client answer

> Submit your answer to a request to client. The answer format depends on the request's `allowed_answer_types` field.

**Answer Types:**
- `yes-no`: Answer with "yes" or "no"
- `yes-no-dontknow`: Answer with "yes", "no", or "dontknow"
- `yes-no-freetext-on-no`: Answer with "yes" or "no"; if "no", provide additional_comment
- `yes-with-date-no-freetext-on-no`: Answer with a date or "no"; if "no", provide additional_comment
- `fileupload`: **Upload documents FIRST** via the documents endpoint, then submit this answer with optional comment



## OpenAPI

````yaml post /v1/mandates/{mandate_id}/requests-to-client/{request_id}/answer/
openapi: 3.0.3
info:
  title: paywise Case Management API
  version: v1
  description: |

    Use our Case Management API to perform the debt entire collection process.

    Please refer to the [official docs][ref1] for more!

    [ref1]: https://docs.paywise.de/api-docs/case-management-api/introduction
servers:
  - url: https://api.paywise.de
    description: Production environment
security: []
externalDocs:
  url: https://docs.paywise.de/api-docs/case-management-api/
paths:
  /v1/mandates/{mandate_id}/requests-to-client/{request_id}/answer/:
    post:
      tags:
        - mandates
      summary: Submit request to client answer
      description: >-
        Submit your answer to a request to client. The answer format depends on
        the request's `allowed_answer_types` field.


        **Answer Types:**

        - `yes-no`: Answer with "yes" or "no"

        - `yes-no-dontknow`: Answer with "yes", "no", or "dontknow"

        - `yes-no-freetext-on-no`: Answer with "yes" or "no"; if "no", provide
        additional_comment

        - `yes-with-date-no-freetext-on-no`: Answer with a date or "no"; if
        "no", provide additional_comment

        - `fileupload`: **Upload documents FIRST** via the documents endpoint,
        then submit this answer with optional comment
      operationId: submit-request-to-client-answer
      parameters:
        - in: path
          name: mandate_id
          schema:
            type: string
            format: uuid
          required: true
        - in: path
          name: request_id
          schema:
            type: string
          required: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AnswerCreateRequest'
            examples:
              Yes/NoAnswer-Confirm:
                value:
                  text: 'yes'
                  additional_comment: null
                summary: Yes/No answer - Confirm
                description: Simple yes/no confirmation answer
              Yes/NoAnswer-DeclineWithComment:
                value:
                  text: 'no'
                  additional_comment: >-
                    Der Schuldner hat bereits am 15.10.2023 eine Zahlung von 500
                    EUR geleistet.
                summary: Yes/No answer - Decline with comment
                description: >-
                  Declining with required explanation (for yes-no-freetext-on-no
                  type)
              UnsureAnswer:
                value:
                  text: dontknow
                  additional_comment: >-
                    Ich bin mir nicht sicher, ob die Zahlung bereits erfolgt
                    ist. Bitte prÃ¼fen Sie die KontoauszÃ¼ge.
                summary: Unsure answer
                description: Answer with "dontknow" for yes-no-dontknow type questions
              FileUploadFinalization:
                value:
                  text: Anbei finden Sie die angeforderten Dokumente zur PrÃ¼fung.
                  additional_comment: null
                summary: File upload finalization
                description: >-
                  Finalize fileupload answer with optional comment (upload
                  documents FIRST via documents endpoint)
              DateAnswer:
                value:
                  text: '2025-10-15'
                  additional_comment: null
                summary: Date answer
                description: Date answer for yes-with-date-no-freetext-on-no type
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/AnswerCreateRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/AnswerCreateRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestToClientPublic'
              examples:
                SuccessfulAnswerResponse:
                  value:
                    id: b2c3d4e5-f6a7-5e44-9f0a-d8e9f0a1b2c3
                    href: >-
                      https://api.paywise.de/v1/mandates/5600672e-2bfa-488c-b23a-460c1dd1f833/requests-to-client/b2c3d4e5-f6a7-5e44-9f0a-d8e9f0a1b2c3/
                    mandate:
                      id: 5600672e-2bfa-488c-b23a-460c1dd1f833
                      href: >-
                        https://api.paywise.de/v1/mandates/5600672e-2bfa-488c-b23a-460c1dd1f833/
                      reference_number: K25-8Q114
                    title: Dokumente angefordert
                    description: >-
                      Wir benÃ¶tigen eine Kopie der Originalrechnung zur
                      PrÃ¼fung.
                    allowed_answer_types: fileupload
                    file_attachments: []
                    answered: true
                    answer:
                      id: c3d4e5f6-a7b8-6f55-0a1b-e9f0a1b2c3d4
                      text: Anbei die angeforderten Dokumente.
                      additional_comment: null
                      files:
                        - id: d4e5f6a7-b8c9-0123-4567-890abcdef012
                          filename: rechnung_RE2023001.pdf
                          mime_type: application/pdf
                          file_size: 234567
                      created: '2025-11-16T14:22:00Z'
                    created: '2025-11-15T08:00:00Z'
                    answered_at: '2025-11-16T14:22:00Z'
                  summary: Successful answer response
                  description: The request after successfully submitting an answer
          description: ''
      security:
        - tokenAuth: []
        - tokenAuth: []
components:
  schemas:
    AnswerCreateRequest:
      type: object
      description: >-
        Serializer for creating/submitting an answer to a RequestToClient.


        The required fields depend on the RequestToClient's
        allowed_answer_types:

        - yes-no: text must be "yes" or "no"

        - yes-no-dontknow: text must be "yes", "no", or "dontknow"

        - fileupload: files are required, text is optional comment

        - yes-no-freetext-on-no: text must be "yes" or "no", additional_comment
        required if "no"

        - yes-with-date-no-freetext-on-no: text must be date (if yes) or "no",
        additional_comment if "no"

        - freetext: text is required
      properties:
        text:
          type: string
          nullable: true
          description: >-
            The answer text. Required for most answer types. For yes-no types,
            use "yes", "no", or "dontknow".
          maxLength: 5000
        additional_comment:
          type: string
          nullable: true
          description: >-
            Additional comment. Required for "no" answers in
            yes-no-freetext-on-no type.
          maxLength: 5000
    RequestToClientPublic:
      type: object
      description: |-
        Main serializer for RequestToClient in the Public API.
        Provides full detail view for GET requests.
      properties:
        id:
          type: string
          readOnly: true
        href:
          type: string
          readOnly: true
        mandate:
          allOf:
            - $ref: '#/components/schemas/MandateMinInfoForRequest'
          readOnly: true
        title:
          type: string
          readOnly: true
        description:
          type: string
          readOnly: true
          nullable: true
        allowed_answer_types:
          readOnly: true
          oneOf:
            - $ref: '#/components/schemas/AllowedAnswerTypesEnum'
            - $ref: '#/components/schemas/NullEnum'
        file_attachments:
          type: array
          items:
            $ref: '#/components/schemas/FileAttachmentPublic'
          readOnly: true
        answered:
          type: boolean
          readOnly: true
        answer:
          allOf:
            - $ref: '#/components/schemas/AnswerPublic'
          readOnly: true
        created:
          type: string
          format: date-time
          readOnly: true
        answered_at:
          type: string
          format: date-time
          nullable: true
          readOnly: true
      required:
        - allowed_answer_types
        - answer
        - answered
        - answered_at
        - created
        - description
        - file_attachments
        - href
        - id
        - mandate
        - title
    MandateMinInfoForRequest:
      type: object
      description: Minimal mandate info for RequestToClient responses.
      properties:
        id:
          type: string
          format: uuid
        href:
          type: string
          readOnly: true
        reference_number:
          type: string
      required:
        - href
        - id
        - reference_number
    AllowedAnswerTypesEnum:
      enum:
        - yes-no
        - yes-no-dontknow
        - fileupload
        - yes-no-freetext-on-no
        - yes-with-date-no-freetext-on-no
        - dynamic-form
      description: |-
        * `None` - ---------
        * `yes-no` - Ja/Nein
        * `yes-no-dontknow` - Ja/Nein/WeiÃŸ nicht
        * `fileupload` - Freitext + Dateiupload
        * `yes-no-freetext-on-no` - Ja/Nein + Freitext bei Nein
        * `yes-with-date-no-freetext-on-no` - Ja + Datum / Nein + Freitext
        * `dynamic-form` - Dynamisches Formular
    NullEnum:
      enum:
        - null
    FileAttachmentPublic:
      type: object
      description: |-
        Serializer for file attachments (on RequestToClient) with download URLs.
        Used for schema generation and response formatting.
      properties:
        id:
          type: string
          format: uuid
          description: Unique UUID identifier of the file attachment
        filename:
          type: string
          description: Original filename of the attachment
        mime_type:
          type: string
          description: MIME type of the file (e.g., application/pdf, image/jpeg)
        file_size:
          type: string
          readOnly: true
          description: File size in bytes
        download_url:
          type: string
          readOnly: true
          description: Secure download URL for the file
      required:
        - download_url
        - file_size
        - filename
        - id
        - mime_type
    AnswerPublic:
      type: object
      description: |-
        Read-only serializer for displaying answers.
        Shows text, additional comment, and uploaded files.
      properties:
        id:
          type: string
          readOnly: true
        text:
          type: string
          readOnly: true
          nullable: true
        additional_comment:
          type: string
          readOnly: true
          nullable: true
        files:
          type: array
          items:
            $ref: '#/components/schemas/AnswerFilePublic'
          readOnly: true
        created:
          type: string
          format: date-time
          readOnly: true
      required:
        - additional_comment
        - created
        - files
        - id
        - text
    AnswerFilePublic:
      type: object
      description: |-
        Serializer for files attached to an Answer (UploadedDocument model).
        Read-only, shows metadata about uploaded answer documents.
      properties:
        id:
          type: string
          format: uuid
          description: Unique UUID identifier of the uploaded document
        filename:
          type: string
          description: Original filename of the document
        mime_type:
          type: string
          description: MIME type of the file
        file_size:
          type: string
          readOnly: true
          description: File size in bytes
      required:
        - file_size
        - filename
        - id
        - mime_type
  securitySchemes:
    tokenAuth:
      type: http
      scheme: bearer

````