---
title: "Many documents → many forms: one read of all the documents (IDs, PSA certificates, bills, payslips, permits) into facts tagged with whose they are (self, spouse, mother, father, child) and which document said them; the same fact in another print is merged, a less complete print folds into the fuller one, and a real disagreement (two birthdays, maiden vs married surname, two home addresses) comes back as a question with each document as an option, an explanation and a suggested answer. Every chosen form is filled from the result. Costs one document reading (10 credits). Facts are not stored — send them back to /engine/dossier/resolve with the answers."
method: POST
path: "/api/v1/engine/dossier"
tags: ["Read"]
---

# Many documents → many forms: one read of all the documents (IDs, PSA certificates, bills, payslips, permits) into facts tagged with whose they are (self, spouse, mother, father, child) and which document said them; the same fact in another print is merged, a less complete print folds into the fuller one, and a real disagreement (two birthdays, maiden vs married surname, two home addresses) comes back as a question with each document as an option, an explanation and a suggested answer. Every chosen form is filled from the result. Costs one document reading (10 credits). Facts are not stored — send them back to /engine/dossier/resolve with the answers.

`POST /api/v1/engine/dossier`

## Request

- Base URL: `https://philforms.com`
- URL: `https://philforms.com/api/v1/engine/dossier`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-PDFPhile-Embed`

## Request body

- object
  - `media` object[], required
    - `type` string, required
    - `data` string
    - `text` string
    - `name` string
  - `form_id` string[], required

## Response `200`

{ document, fact, conflict, question, note, is_settled, form: { <form_id>: { data, filled, missing_core } } }

## Other responses

- `400`: Bad media
- `402`: The month cannot pay for it / free daily cap
- `403`: AI reading is off for this organization
- `404`: Unknown form
- `503`: Not configured on this server

---

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