Skip to main content
POST
/
v1
/
mandates
/
{mandate_id}
/
requests-to-client
/
{request_id}
/
answer
/
documents
/
Upload document to request to client answer
curl --request POST \
  --url https://api.paywise.de/v1/mandates/{mandate_id}/requests-to-client/{request_id}/answer/documents/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "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 uploading documents to an answer. Used for the separate document upload endpoint.

​
file
file
required

Document file to upload. Allowed formats: PDF, JPEG, PNG.

Response

201 - 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