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

# Fax Status

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

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.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/revisions/e6e553c2594a/schema)