---
title: "Send submission-request email"
method: POST
path: "/supporting-documents/submission-requests/{id}/send/"
tags: ["Billing"]
---

# Send submission-request email

`POST /supporting-documents/submission-requests/{id}/send/`

Sends the request email to `recipients` and marks the request as
`sent`. Fails if the request is already `fulfilled` or `cancelled`,
if `recipients` is empty, or if SMTP delivery fails.

## Response `200`

Sent submission request.

- SubmissionRequest — Request sent to a customer asking for required documentation (purchase order, HES) before billing can proceed.
  - `id` integer
  - `customer` string, required — Customer ID.
  - `submission_type` 'order' | 'hes', required — `order` = Purchase Order. `hes` = Service Entry Sheet.
  - `status` 'pending' | 'sent' | 'overdue' | 'fulfilled' | 'cancelled'
  - `recipients` string[]
  - `subscriptions` string[] — IDs of subscriptions this request is tied to. Must belong to the customer.
  - `due_date` string, date, nullable
  - `is_automatic` boolean
  - `billing_cycle` integer, nullable
  - `email_subject` string
  - `email_message` string
  - `sent_at` string, date-time, nullable
  - `fulfilled_at` string, date-time, nullable
  - `created` string, date-time

## Other responses

- `400` — Request body or query parameters failed validation.

---

[API](https://skmtc.net/piriod/apis/piriod-api.md) · [All operations](https://skmtc.net/piriod/apis/piriod-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/piriod/piriod-api/versions/70cbc827dc7b/schema)