List Received Faxes
GET /received_faxes — Returns a paginated list of received faxes for your account.
Query params: page, page_size, from_number, to_number, caller_name, date_start, date_end, fax_status, is_test, client, callback_status.
bash
Response
JSON
Response Fields
| Field | Description |
|---|---|
| send_token | Unique identifier for this fax |
| from_number | The fax number that sent this fax |
| to_number | Your Medsender fax number that received it |
| caller_name | Caller ID name from the sending fax machine |
| fax_status | Reception status: "success" or "failure" |
| sent_at | When the fax started transmitting (ISO 8601) |
| completed_at | When the fax finished receiving (ISO 8601) |
| num_pages | Number of pages received |
| is_test | Whether this was a test fax |
| error_details | Error information if fax_status is "failure" |
| callback_status | Status of webhook delivery: "success", "failure", or "pending" |
| client | Client ID if the fax number is assigned to a client |
AI Extraction Fields (populated when AI extraction is enabled for your account):
| document_classification | Document type: "Referral", "Lab Result", "Prior Authorization", etc. |
| patient_name | Full patient name extracted from document |
| patient_first_name | Patient first name |
| patient_middle_name | Patient middle name |
| patient_last_name | Patient last name |
| patient_dob | Patient date of birth (YYYY-MM-DD) |
| insurance_member_id | Insurance member ID |
| reference_number | Reference number from document |
| authorization_number | Prior authorization number |
| codes | Array of medical codes (CPT, ICD, etc.) |
| auth_date_range_start | Authorization start date |
| auth_date_range_end | Authorization end date |
| denial_reason | Denial reason if document is a denial |