---
title: "Ein BELIEBIGES (nicht-Katalog-)PDF ausfüllen und optional signieren → fertiges PDF (base64). answers = Feldname→Wert (aus inspect_pdf). Unterschrift wird in erkannte Signaturfelder gesetzt oder per manualPlacement platziert. lang (optional) wählt die Schrift für nicht-lateinische Eingaben (ar/zh/hi/…)."
method: POST
path: "/tools/fill_pdf"
---

# Ein BELIEBIGES (nicht-Katalog-)PDF ausfüllen und optional signieren → fertiges PDF (base64). answers = Feldname→Wert (aus inspect_pdf). Unterschrift wird in erkannte Signaturfelder gesetzt oder per manualPlacement platziert. lang (optional) wählt die Schrift für nicht-lateinische Eingaben (ar/zh/hi/…).

`POST /tools/fill_pdf`

## Request

- Base URL: `https://api.tamgara.com/api/v1`
- URL: `https://api.tamgara.com/api/v1/tools/fill_pdf`
- Auth: none declared

## Request body

- object
  - `pdfBase64` string, required: Das auszufüllende PDF (base64).
  - `answers` object: Feldname → Wert (String/Boolean).
  - `signaturePngDataUrl` string: Unterschrift als PNG data:-URL (optional).
  - `lang` string: Sprachhinweis für die Schrift (z. B. ar, zh, hi) — optional.
  - `manualPlacement` object
    - `pageIndex` integer: Seitenindex (0-basiert).
    - `xRatio` number: X 0..1.
    - `yRatio` number: Y 0..1 von oben.
  - `extraText` object
    - `text` string: Zusatztext (z. B. Ort, Datum).
    - `placement` object
      - `pageIndex` integer: Seitenindex.
      - `xRatio` number: X 0..1.
      - `yRatio` number: Y 0..1 von oben.
  - `filename` string: Dateiname (optional).

## Response `200`

OK

## Other responses

- `400`: Fehler / ungültige Eingabe

---

[API](https://skmtc.dev/tamgara/apis/tamgara-api.md) · [All operations](https://skmtc.dev/tamgara/apis/tamgara-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tamgara/apis/tamgara-api/revisions/9435a5dea6d8?raw)