​

Fax

​

Send a fax

curl -X POST https://api.orbit.devotel.io/api/v1/messages/fax \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "from": "+18005551234",
    "media_url": "https://example.com/contract.pdf",
    "quality": "high",
    "status_callback": "https://example.com/webhooks/fax",
    "metadata": { "order_id": "ord_123" }
  }'

​

Response

{
  "data": {
    "id": "msg_a1b2c3d4e5f6g7h8",
    "status": "queued",
    "channel": "fax"
  },
  "meta": {
    "request_id": "req_xyz789",
    "timestamp": "2026-05-09T00:00:00Z"
  }
}

​

Capabilities

• Outbound fax — PDF or TIFF input; carrier converts to T.38 packets in real time.
• Inbound fax — incoming faxes are stored as PDF in Orbit’s secure storage, with the page count, sender ANI, and a download URL POSTed to your webhook.
• Quality — set quality to normal, high, or very_high to control the fax resolution.
• Document size — PDF or TIFF up to 50 MB per outbound fax (Telnyx’s hard media-size limit); multi-page documents are supported, with no separate page-count cap.
• Delivery status — outbound fax outcomes arrive on the channel-agnostic message.delivered / message.failed webhook events with channel: "fax" (there is no separate fax.* event to subscribe to). Each payload carries message_id, status, state_class, and is_terminal for reconciliation.
• Per-tenant carrier connection — orgs can attach a dedicated Telnyx Fax application for compliance / data-residency.

​

Status flow

​

Common errors

​

Failed transmissions

​

Pricing