---
title: "Fax Status"
method: GET
path: "/v1/fax/status/{id}"
tags: ["Fax Services"]
---

# Fax Status

`GET /v1/fax/status/{id}`

## Request

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

Retrieve the current status and details of a fax by its ID.

## Path parameters

- `id` string, required

## Response `200`

Default Response

- object
  - `id` string, required: 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
  - `updatedAt` string, required: ISO timestamp when status was last updated
  - `deliveredAt` string: ISO timestamp when fax was delivered
  - `errorMessage` string: Error message if fax failed
  - `pageCount` number: Number of pages in the fax
  - `duration` number: Call duration in seconds
  - `cost` number: Cost of the fax
  - `providerData` object: Provider-specific additional data

## Other responses

- `400`: Default Response
- `401`: Default Response
- `404`: Default Response
- `500`: Default Response

---

[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)