---
title: "Fill a document"
method: POST
path: "/api/v1/documents/{document_id}/fill"
tags: ["Fill"]
---

# Fill a document

`POST /api/v1/documents/{document_id}/fill`

## Request

- Base URL: `https://www.ifillpdf.com`
- URL: `https://www.ifillpdf.com/api/v1/documents/{document_id}/fill`
- Auth: HTTP bearer

Applies values to the analyzed schema and returns the filled PDF, or a signed URL when format=url is requested or the PDF is too large for a direct response.

## Path parameters

- `document_id` string, uuid, required

## Query parameters

- `format` 'pdf' | 'url'

## Request body

- FillRequest
  - `values` DocumentValues, required
  - `watermark` boolean

## Response `200`

Filled PDF binary, or a signed URL response.

- FillUrlResponse
  - `url` string, uri, required
  - `expires_in` integer, required
  - `filled` integer, required
  - `failed` string[], required

## Other responses

- `409`: Document analysis has not produced a schema yet.

---

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