Incoming Fax

Manage incoming faxes received via webhook. List, retrieve content, reprocess, and monitor incoming fax processing.

7 endpoints

Guide

Manage incoming faxes received via webhook from fax providers. BlueHive automatically processes incoming faxes — scanning for QR codes, identifying orders, splitting multi-page documents, and routing results to the correct order items.

How Incoming Faxes Work

When a fax is received, BlueHive processes it through an automated pipeline:

  • Fax arrives via webhook from the provider (e.g., RingCentral)
  • The document is stored and queued for processing
  • Pages are scanned for QR codes that identify order items
  • Multi-page faxes are split into individual documents per order item
  • Split documents are matched to orders and results are uploaded
  • If an HL7 system is configured, results are forwarded via HL7

Listing Incoming Faxes

Retrieve recently received faxes. Use the since parameter to get only faxes received after a specific time.

List recent incoming faxes
Get incoming faxes from the last 24 hours
curl "https://api.bluehive.com/v1/fax/incoming?since=2026-03-08T00:00:00Z&limit=50" \
  -H "Authorization: ApiKey YOUR_API_KEY"

Reprocessing Faxes

If a fax failed initial processing (e.g., QR code recognition issue), you can requeue it for reprocessing. This is useful after fixing data issues or updating QR code templates.

Reprocess a fax
Re-enqueue a fax for processing
curl -X POST "https://api.bluehive.com/v1/fax/incoming/fax_abc123/reprocess" \
  -H "Authorization: ApiKey YOUR_API_KEY"
Chat with Bea