Skip to main content
POST
/
v1
/
mandates
/
{mandate_id}
/
requests-to-client
/
{request_id}
/
answer
Submit request to client answer
curl --request POST \
  --url https://api.paywise.de/v1/mandates/{mandate_id}/requests-to-client/{request_id}/answer/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "<string>",
  "additional_comment": "<string>"
}
'
{
  "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"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
mandate_id
string<uuid>
required
​
request_id
string
required

Body

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
​
text
string | null

The answer text. Required for most answer types. For yes-no types, use "yes", "no", or "dontknow".

Maximum string length: 5000
​
additional_comment
string | null

Additional comment. Required for "no" answers in yes-no-freetext-on-no type.

Maximum string length: 5000

Response

200 - application/json

Main serializer for RequestToClient in the Public API. Provides full detail view for GET requests.

​
id
string
required
​
href
string
required
​
mandate
object
required

Minimal mandate info for RequestToClient responses.

​
title
string
required
​
description
string | null
required
​
allowed_answer_types
required
  • 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
Available options:
yes-no,
yes-no-dontknow,
fileupload,
yes-no-freetext-on-no,
yes-with-date-no-freetext-on-no,
dynamic-form
​
file_attachments
object[]
required
​
answered
boolean
required
​
answer
object
required

Read-only serializer for displaying answers. Shows text, additional comment, and uploaded files.

​
created
string<date-time>
required
​
answered_at
string<date-time> | null
required