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 |
|---|---|
| sendToken | Unique identifier for this fax |
| fromNumber | The fax number that sent this fax |
| toNumber | Your Medsender fax number that received it |
| callerName | Caller ID name from the sending fax machine |
| faxStatus | Reception status: "success" or "failure" |
| sentAt | When the fax started transmitting (ISO 8601) |
| completedAt | When the fax finished receiving (ISO 8601) |
| numPages | Number of pages received |
| isTest | Whether this was a test fax |
| errorDetails | Error information if faxStatus is "failure" |
| callbackStatus | Status of webhook delivery: "success", "failed", "pending", or null |
| client | Client ID if the fax number is assigned to a client |
AI Extraction Fields (populated when AI extraction is enabled for your account):
| documentClassification | Document type: "Referral", "Lab Result", "Prior Authorization", etc. |
| patientName | Full patient name extracted from document |
| patientFirstName | Patient first name |
| patientMiddleName | Patient middle name |
| patientLastName | Patient last name |
| patientDob | Patient date of birth (YYYY-MM-DD) |
| insuranceMemberId | Insurance member ID |
| referenceNumber | Reference number from document |
| authorizationNumber | Prior authorization number |
| codes | Medical codes as stored text, or null; the text is not guaranteed to be JSON |
| authDateRangeStart | Authorization start date |
| authDateRangeEnd | Authorization end date |
| denialReason | Denial reason if document is a denial |