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

# Send Fax

`POST /v1/fax/send`

## Request

- Base URL: `https://api.bluehive.com`
- URL: `https://api.bluehive.com/v1/fax/send`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bluehive-health/apis/bluehive-api/docs/v1/fax/send/post.ts> (a function with typed inputs; its response is checked against the schema)

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

## Changes

- **2026-02-05** `63bca4bb1614`: 1 info
  - added the non-success response with the status `403`

[Operation history](https://skmtc.dev/bluehive-health/apis/bluehive-api/changes/v1/fax/send/post.md)

---

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