Faxes

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

Properties

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"
}

Attribute
account_sid string	The unique identifier for the account this fax is associated with.
date_created string	The date and time, in ISO 8601 format, the fax was created.
date_updated string	The date and time, in ISO 8601 format, the fax was updated.
direction string	The direction of the fax. Possible values are inbound or outbound.
duration integer	The time, in seconds, it took to deliver a fax.
from string	The phone number, in E.164 format, the fax was sent from.
links object	The URL links for resources associated with the fax.
media_sid string	The unique identifier for the media instance associated with the fax instance.
media_url string	The URL hosting the received media. Can use this URL to download incoming media.
num_pages string	The number of pages in the fax document.
price string	The cost of the fax.
price_unit string	The currency, in ISO 4217 format, of the price.
quality string	The quality of the fax. See below for possible values.
sid string	The unique identifier of the fax.
status string	The status of the fax. See below for possible values.
to string	The phone number, in E.164 format, the fax was sent to.
url string	The URL of this resource.

Quality

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

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.