Get outbound fax list

Returns a list of recent outbound faxes. Batch faxes are not included.

Endpoint

Copy

GET /outbound/faxes[?limit={number}&lastId={number}&sortOrder={asc|desc}&userId={string}]

Parameters

Name	Type	Required	Description	Default
`limit`	`Number`	No	The number of fax transactions to return, up to a maximum of 250.	25
`lastId`	`Number`	No	Returns results starting after this fax ID. The specified ID is not included. Use this parameter for pagination.	When `sortOrder` is `desc`, the default is the highest available fax ID; when `sortOrder` is `asc`, the default is `0`
`sortOrder`	`String`	No	Specifies the sort order for fax IDs. Accepted values are `asc` and `desc`.	`desc`
`userId`	`String`	No	Allows a primary user to retrieve faxes belonging to another user on the account.	Current authenticated user

Response

If successful, the API returns an array of outbound fax objects at the full detail level.

Name	Type	Description	Detail Level
Name	Type	Description	Result	Summary	Full
`submitTime`	`DateTime`	The date and time the transaction was originally submitted. Times are in GMT.
`contact`	`String`	The text inserted into the Contacts property when the fax was submitted. This property is available only with certain submission methods.
`destinationFax`	`String`	The resolved fax number to which the fax was sent.
`replyEmail`	`String`	The email address for the confirmation message.
`subject`	`String`	A name or other optional identifier.
`pagesSubmitted`	`Integer`	The total number of pages submitted.
`senderCSID`	`String`	The sender’s fax ID.
`attemptsToPerform`	`Integer`	The maximum number of transmission attempts to make if the fax transmission fails.
`pageSize`	`String`	The page size. Accepted values are `A4`, `Letter`, `Legal`, and `B4`.
`pageResolution`	`String`	The page resolution. Accepted values are `Standard`and `Fine`.
`pageOrientation`	`String`	The page orientation. Accepted values are `Portrait` and `Landscape`.
`rendering`	`String`	The rendering mode. Accepted values are `Standard` (optimized for black and white) or `Fine` (optimized for grayscale).
`pageHeader`	`String`	The fax header text inserted at the top of the page.
`userId`	`String`	The ID of the user who submitted the fax.
`pagesSent`	`Integer`	The number of successfully sent pages.
`completionTime`	`DateTime`	The date and time the last transmission attempt ended. Times are in GMT.
`remoteCSID`	`String`	The receiving party fax ID, up to 20 characters.
`duration`	`Integer`	The transmission time, in seconds.
`priority`	`Integer`	For internal use.
`units`	`Integer`	The number of billable units. Units are measured in pages or tenths of minutes.
`costPerUnit`	`Decimal`	The monetary cost of each unit, in the account currency. Multiply this value by `units` to calculate the actual cost of the fax.
`attemptsMade`	`Integer`	The number of transmission attempts actually performed.
`id`	`Integer`	A unique identifier for the fax.
`uri`	`String`	A unique resource locator for the fax.
`status`	`Integer`	The status of the fax. See Fax status codes.

Sample calls

Raw HTTP

Copy

GET /outbound/faxes HTTP/1.1
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
Host: rest.interfax.net

cURL

Get outbound fax list

Copy

curl "https://rest.interfax.net/outbound/faxes" ^
    -u username:password

Get up to 10 results in ascending sort order

Copy

curl "https://rest.interfax.net/outbound/faxes?limit=10&sortOrder=asc" ^
    -u username:password

Sample response

Copy

[
  {
    "submitTime": "2026-09-04T09:13:56",
    "contact": "John Smith",
    "destinationFax": "15551234567",
    "replyEmail": "user@example.com",
    "subject": null,
    "pagesSubmitted": 1,
    "senderCSID": "9876543210",
    "attemptsToPerform": 1,
    "pageSize": "B4",
    "pageResolution": "Fine",
    "pageOrientation": "Portrait",
    "rendering": "Standard",
    "pageHeader": "{to} {from} {totalpages} {pagenumber} {datelong} {timehhmm}",
    "userId": "myuserid",
    "pagesSent": 1,
    "completionTime": "2026-09-04T09:14:04",
    "remoteCSID": "1234567890",
    "duration": 32,
    "priority": 5,
    "units": 1,
    "costPerUnit": 0.2,
    "attemptsMade": 1,
    "id": 123456,
    "uri": "https://rest.interfax.net/outbound/faxes/123456",
    "status": 0
  },
  {
     "submitTime": "2026-08-11T17:05:08",
     "contact": null,
     "destinationFax": "00442033487004",
     "replyEmail": "user2@example.com",
     "subject": null,
     "pagesSubmitted": 1,
     "senderCSID": "98765432101",
     "attemptsToPerform": 1,
     "pageSize": "B4",
     "pageResolution": "Fine",
     "pageOrientation": "Portrait",
     "rendering": "Fine",
     "pageHeader": "{to} {from} {totalpages} {pagenumber} {datelong} {timehhmm}",
     "userId": "myuserid1",
     "pagesSent": 1,
     "completionTime": "2026-08-11T17:05:17",
     "remoteCSID": "12345678901",
     "duration": 33,
     "priority": 5,
     "units": 1.00,
     "costPerUnit": 0.7400,
     "attemptsMade": 1,
     "id": 1234567,
     "uri": "https://rest.interfax.net/outbound/faxes/1234567",
     "status": 0
    }
  
]