---
title: "Request Documents"
method: POST
path: "/api/businesses/{business_id}/request-documents"
tags: ["Businesses"]
---

# Request Documents

`POST /api/businesses/{business_id}/request-documents`

## Request

- Base URL: `https://api.flagpost.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.flagpost.ai/api/businesses/{business_id}/request-documents`
- Auth: HTTP bearer

Send document request list to seller via email.

Combines template documents with custom documents and sends to business contact_email.

Args:
    business_id: Business UUID
    request: Template ID, custom documents, message, and due date

Returns:
    Dictionary with status and email sent confirmation

## Path parameters

- `business_id` string, required

## Request body

- DocumentRequestRequest: Request to send document request list to seller.
  - `template_id` string, nullable
  - `custom_documents` string[], nullable
  - `message` string, nullable
  - `due_date` string, nullable
  - `custom_subject` string, nullable
  - `custom_body_html` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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