---
title: "File a research request's missing data"
method: POST
path: "/v1/research-requests/{id}/file-gaps"
---

# File a research request's missing data

`POST /v1/research-requests/{id}/file-gaps`

## Request

- Base URL: `https://api.ploti.ai`
- URL: `https://api.ploti.ai/v1/research-requests/{id}/file-gaps`
- Auth: HTTP bearer

File the missing data Ploti could not file itself when the research request's data check reported: it files what it can then, and this files the rest once whatever stopped it is resolved (research credits ran short, or a place was outside the workspace's coverage). Filed data uses the workspace's research credits. A request needing more than 20 datasets files the first 20 and waits: call again with continue=true when the user wants the rest. Filing again is safe: a piece already filed is not filed twice.

## Path parameters

- `id` string, required

## Request body

- object
  - `continue` boolean: Also file the gaps past the per-request ceiling, when the user wants the rest; left out, filing stops at the ceiling.

## Response `200`

Done

- object
  - `request` object, required
    - `id` string, required
    - `title` string, required
    - `status` 'checking' | 'needs_answer' | 'report_ready' | 'data_requested' | 'researching' | 'complete', required
    - `statusText` string, required
    - `links` object, required
      - `view` string, required
  - `gaps` object[], required
    - `title` string, required
    - `result` 'filed' | 'waiting_for_trial' | 'over_ceiling' | 'outside_coverage' | 'failed', required
    - `detail` string, nullable, required
  - `links` object, required
    - `coverage` string, required

## Other responses

- `401`: The credential is missing or not valid.
- `413`: payload_too_large: the body is over 256 KB (2 MB for /v1/tools).
- `415`: unsupported_media_type: a body was sent without Content-Type: application/json.
- `429`: rate_limited: this credential is over its rate. Retry after the Retry-After header's seconds.
- `500`: internal: Ploti failed. Retry; if it keeps happening, contact support.
- `default`: Refused: nothing was done. The code says why and the links say where the person acts on it.

---

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