Skip to main content

Faxes

A Fax is a fax that has been sent to or received by a SignalWire phone number.

Faxes remain stored indefinitely, until deleted with the appropriate API call.

Properties

AttributeType
account_sidstringThe unique identifier for the account this fax is associated with.
date_createdstringThe date and time, in ISO 8601 format, the fax was created.
date_updatedstringThe date and time, in ISO 8601 format, the fax was updated.
directionstringThe direction of the fax. Possible values are inbound or outbound.
durationintegerThe time, in seconds, it took to deliver a fax.
fromstringThe phone number, in E.164 format, the fax was sent from.
linksobjectThe URL links for resources associated with the fax.
media_sidstringThe unique identifier for the media instance associated with the fax instance.
media_urlstringThe URL hosting the received media. Can use this URL to download incoming media.
num_pagesstringThe number of pages in the fax document.
pricestringThe cost of the fax.
price_unitstringThe currency, in ISO 4217 format, of the price.
qualitystringThe quality of the fax. See below for possible values.
sidstringThe unique identifier of the fax.
statusstringThe status of the fax. See below for possible values.
tostringThe phone number, in E.164 format, the fax was sent to.
urlstringThe URL of this resource.

A sample Fax returned from the API:

{
"account_sid": "b3877c40-da60-4998-90ad-b792e98472ac",
"api_version": "v1",
"date_created": "2018-11-26T20:00:00Z",
"date_updated": "2018-11-27T20:00:00Z",
"direction": "outbound",
"from": "+13103383454",
"media_url": "https://example.com/fax.pdf",
"media_sid": "b3877c40-da60-4998-90ad-b792e98472me",
"num_pages": null,
"price": null,
"price_unit": null,
"quality": null,
"sid": "b3877c40-da60-4998-90ad-b792e98472fx",
"status": "queued",
"to": "+13104456789",
"duration": null,
"links": {
"media": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472ac/Faxes/b3877c40-da60-4998-90ad-b792e98472fx/Media"
},
"url": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472ac/Faxes/b3877c40-da60-4998-90ad-b792e98472fx"
}


Quality Values

The quality attribute has the following values:

Value
standard A low quality (204x98) fax resolution. This quality should be supported by all devices.
fine A medium quality (204x196) fax resolution.
superfine A high quality (204x392) fax resolution.


Status Values

The status attribute has the following values:

Value
queued The fax is queued and waiting for processing.
processing The fax is being uploaded, downloaded, or converted to a different format.
sending The fax is being sent.
delivered The fax has been successfully sent.
receiving The fax is being received.
received The fax has been successfully received.
no-answer The fax failed because the recipient didn't pick up.
busy The fax failed because the receiving machine sent back a busy signal.
failed The fax failed to send or receive.
canceled The fax was canceled.