List sent faxes
curl --request GET \
--url https://api.healos.ai/ext-api/v1/faxes/outbound \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.healos.ai/ext-api/v1/faxes/outbound', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.healos.ai/ext-api/v1/faxes/outbound"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "0f000000-0000-4000-8000-000000000001",
"created_at": "<string>",
"to_number": "+15555550199",
"to_name": "<string>",
"subject": "<string>",
"status": "queued",
"status_detail": "<string>",
"pages_sent": 123,
"total_pages": 123,
"fax_id": "<string>",
"retry_count": 123,
"delivered_at": "<string>",
"failed_at": "<string>",
"canceled_at": "<string>"
}
],
"meta": {
"page": 123,
"limit": 123,
"total_pages": 123
}
}{
"error": "<string>",
"details": {}
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "Rate limit exceeded. Please retry after the window resets.",
"code": "daily_cap_reached",
"reset_at": "2026-10-28T00:00:00.000Z"
}Fax
List sent faxes
Faxes your organization sent, newest first, with their stored delivery status. Requires the fax:read scope.
GET
/
faxes
/
outbound
List sent faxes
curl --request GET \
--url https://api.healos.ai/ext-api/v1/faxes/outbound \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.healos.ai/ext-api/v1/faxes/outbound', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.healos.ai/ext-api/v1/faxes/outbound"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "0f000000-0000-4000-8000-000000000001",
"created_at": "<string>",
"to_number": "+15555550199",
"to_name": "<string>",
"subject": "<string>",
"status": "queued",
"status_detail": "<string>",
"pages_sent": 123,
"total_pages": 123,
"fax_id": "<string>",
"retry_count": 123,
"delivered_at": "<string>",
"failed_at": "<string>",
"canceled_at": "<string>"
}
],
"meta": {
"page": 123,
"limit": 123,
"total_pages": 123
}
}{
"error": "<string>",
"details": {}
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "Rate limit exceeded. Please retry after the window resets.",
"code": "daily_cap_reached",
"reset_at": "2026-10-28T00:00:00.000Z"
}| Requirement | Detail |
|---|---|
| Scope | fax:read (rolling out: not yet on api.healos.ai) |
| Rate limit | About 60 requests per minute per API key (shared by all endpoints; approximate) |
| Cost | Free |
Safety
- Writes data: No
- Safe to retry: Yes
- Contacts an outside system: None
- Dry run: Not needed (read-only).
Authorizations
API key obtained from /api/v1/ext-api-keys
Query Parameters
Page number, from 1.
Pattern:
^\d+$Example:
"1"
Results per page, 1-100 (default 20). Larger values are treated as 100.
Pattern:
^\d+$Example:
"20"
Available options:
queued, submitting, sending, delivered, failed, canceled Was this page helpful?

