List all Faxes
GET/Accounts/:AccountSid/Faxes
The ability to read all of the faxes that are associated with your Account. This will be returned as a list of faxes.
Permissions
The API token must include the following scopes: Fax.
Request
Path Parameters
The Project ID that uniquely identifies the Account to retrieve.
Query Parameters
Responses
- 200
OK
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
meta
object
The name of the object
faxes
object[]
The unique identifier for the account this fax is associated with.
The version of the SignalWire API.
The date and time, in ISO 8601 format, the fax was created.
The date and time, in ISO 8601 format, the fax was updated.
Possible values: [inbound
, outbound
]
The direction of the fax. Possible values are inbound
or outbound
.
The phone number, in E.164 format, the fax was sent from.
The URL hosting the received media. Can use this URL to download incoming media. Optionally pass a username and password using the format "https://user:pass@example.com/path/to/fax.pdf".
ThThe unique identifier for the media instance associated with the fax instance.
The number of pages in the fax document.
The cost of the fax.
The currency, in ISO 4217 format, of the price.
Possible values: [standard
, fine
, superfine
]
The quality of the fax.
The unique identifier of the fax.
Possible values: [queued
, processing
, sending
, delivered
, receiving
, received
, no-answer
, busy
, failed
, canceled
]
The status of the fax.
The phone number, in E.164 format, the fax was sent to.
The time, in seconds, it took to deliver a fax.
links
object
The URL links for resources associated with the fax.
Media associated with this fax.
The URL of this resource.
Error code for this resource (if available).
The description of this error (if available).
{
"meta": {
"uri": "string",
"first_page_uri": "string",
"next_page_uri": "string",
"previous_page_uri": "string",
"page": 0,
"page_size": 0,
"key": "faxes"
},
"faxes": [
{
"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": "standard",
"sid": "b3877c40-da60-4998-90ad-b792e98472fx",
"status": "queued",
"to": "+13104456789",
"duration": "5000",
"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",
"error_code": "34004",
"error_message": "The call dropped prematurely"
}
]
}