Faxes
Get a fax record
Get a specific fax record details like duration, pages etc. (Permitted scopes: fax:all:read, fax:fax:read)
GET
/
accounts
/
{user_id}
/
faxes
/
{fax_id}
Authorizations
Authorization
string
headerrequiredOAuth2 Authorization Grant
Path Parameters
user_id
string
default: selfrequiredself or user id of a corporate member
fax_id
string
requiredResponse
200 - application/json
comment
string
requiredFree-form comment
cost_details
object
requiredid
string
requiredFax ID
owner_id
string
requiredUser ID of the fax owner
pages
integer
requiredNumber of pages in the fax
Required range:
x > 0
status
enum<string>
requiredFax status
Available options:
success
, partially_sent
, partially_received
, insufficient_credit
, failed
, failed_internal_process_error
, failed_user_busy
, failed_no_answer
, failed_unallocated_number
, failed_office_converter_issue
, failed_separate_file_pages_issue
, failed_render_header_issue
, failed_invalid_number_format
, failed_mimetype_not_supported
, failed_destination_not_supported
, failed_image_preparation
, failed_to_send
, failed_normal_temporary_failure
, failed_unknown_converter_issue
, failed_normal_clearing
, failed_convert_to_tiff_issue
, failed_fs_49
, failed_fs_2
cost
integer
Fax cost in the user currency
Required range:
x > 0
description
string
direction
enum<string>
Fax direction
Available options:
outgoing
, incoming
duration
integer
Required range:
x > 0
file
string
Fax file ID for the getFile handle
file_name
string
Human-readable file name
from
string
Sender number. Might be a userId for faxes sent or received with free accounts
header
string
is_read
boolean
is_spam
boolean
True if the fax is marked as spam
last_update
string
max_retry
integer
Maximum number of retries
Required range:
0 < x < 3
retry_delay
integer
Delay between two retries
Required range:
0 < x < 30
scheduled_time
string
start_time
string
Time at which faxing session started. Format: YYYY-MM-DD HH:mm:ss
submit_time
string
Time when the fax was submitted for sending. For outgoing faxes only
to
string
Fax destination number. Might be a userId for faxes sent or received with free accounts
cover_page
object
Fax cover page