curl --request GET \
  --url https://api.healos.ai/ext-api/v1/faxes \
  --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', 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"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "data": [
    {
      "id": "f0000000-0000-4000-8000-000000000001",
      "received_at": "2026-11-05T15:00:00.000Z",
      "source": "ifax",
      "from_number": "+15555550123",
      "filename": "<string>",
      "file_type": "pdf",
      "pages": 123,
      "document_type": "prescription",
      "is_urgent": true,
      "processing_status": "completed",
      "patient_id": "<string>",
      "ehr_filing": {
        "status": "synced",
        "ehr": "modmed",
        "ehr_patient_id": "<string>",
        "ehr_document_id": "<string>",
        "filed_at": "2026-11-05T15:04:05.000Z"
      }
    }
  ],
  "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"
}