# Get checklist validation results for a directory (folder)
Source: https://docs.file.ai/api-reference/folders/get-checklist-validation-results-for-a-directory-folder

> Evaluate every AI checklist that targets this folder and return the pass/fail verdict for each, with the counts behind it and the document types it is still missing.

get /prod/v1/directories/{directoryId}/checklist-validation

Evaluate every AI checklist that targets this folder and return the pass/fail verdict for each, with the counts behind it and the document types it is still missing.

The evaluation runs when you call: there is no stored result to poll for and no "pending" state. A checklist is judged on the folder as it is at that moment.

**Path Parameters:**
- `directoryId` (required): The directory to evaluate

**Query Parameters:**
- `skipCache` (optional, default `false`): Re-run the underlying queries instead of reading the cached result. The cache is invalidated whenever the folder's contents change through this API, so the default is correct for almost every caller; pass `true` only when a change was made by another path and you need the folder re-read now. It is a heavy folder-tree query, so prefer the default. Accepts `true`, `false`, `1` or `0` — any other value is a 422.

**Response:**
- `pass` / `fail`: how many entries in `checklists` passed and failed. Counts of checklists, NOT of documents. `fail: 0` is the all-passed case.
- `checklists`: one entry per checklist targeting the folder, each with `checklistId`, `checklistName`, `status`, `summary` and `missingSchemas`.

Each `summary` carries all three keys, 0 when unused:
- `missing`: required document types absent from the folder
- `complete`: present documents with every required field filled
- `incomplete`: present documents with at least one required field empty

**Notes:**
- A checklist passes when `missing` and `incomplete` are both 0.
- `missingSchemas` names the document types behind `missing` (deduped, `schemaId` + `schemaName`). It is always present and empty on a passing checklist. Prefer it over inferring the types from the count.
- A presence-only checklist (no field rules) reports `complete: 0, incomplete: 0` and is judged on `missing` alone.
- `checklists: []` means no checklist targets this folder. It is NOT an all-passed result, and no other field distinguishes the two — check the array before reading `fail: 0` as a pass.
- A checklist with no name is returned as `Untitled checklist`.
- `directoryId` is echoed back in canonical lowercase form regardless of the case you send.
- This endpoint only reads. It never changes the folder, its files, or any checklist.