---
title: "Send Fax"
method: POST
path: "/v1/fax/send"
tags: ["Fax Services"]
---

# Send Fax

`POST /v1/fax/send`

Send a fax document to a specified number using the configured fax provider.

## Request body

- object
  - `to` string, required — Recipient fax number (E.164 format preferred)
  - `from` string — Sender fax number (optional, uses default if not provided)
  - `subject` string — Subject line for the fax
  - `document` object, required
    - `content` string, required — Base64 encoded document content
    - `contentType` 'application/pdf' | 'image/tiff' | 'image/tif' | 'image/jpeg' | 'image/jpg' | 'image/png' | 'text/plain', required — MIME type of the document
    - `filename` string — Optional filename for the document
  - `provider` string — Optional provider override (uses default if not specified)

## Response `200`

Default Response

- object
  - `id` string, required — Unique fax identifier
  - `status` 'queued' | 'dialing' | 'sending' | 'delivered' | 'failed' | 'cancelled' | 'retrying', required — Current fax status
  - `provider` string, required — Provider used to send the fax
  - `to` string, required — Recipient fax number
  - `from` string, required — Sender fax number
  - `createdAt` string, required — ISO timestamp when fax was created
  - `estimatedDelivery` string — Estimated delivery time (ISO timestamp)

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `500` — Default Response

---

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