Skip to main content

List all Fax Applications

GET 
/fax_applications

This endpoint returns a list of your Fax Applications inside the 'data' attribute of the response. You can adjust which applications are listed by using filters. Fax Applications are used to configure how you send and receive faxes using the Programmable Fax API with Telnyx.

Request

Query Parameters

    page[number] integer

    Possible values: >= 1

    Default value: 1

    The page number to load

    page[size] integer

    Possible values: >= 1 and <= 250

    Default value: 20

    The size of the page

    filter[application_name][contains] string

    If present, applications with application_name containing the given value will be returned. Matching is not case-sensitive. Requires at least three characters.

    filter[outbound_voice_profile_id] int64

    Identifies the associated outbound voice profile.

    sort string

    Possible values: [created_at, application_name, active]

    Default value: created_at

    Specifies the sort order for results. By default sorting direction is ascending. To have the results sorted in descending order add the - prefix.

    That is:

    • application_name: sorts the result by the application_name field in ascending order.
    • -application_name: sorts the result by the application_name field in descending order.

    If not given, results are sorted by
    created_at
    in descending order.

Responses

200: Successful response

400: Bad request, the request was unacceptable, often due to missing a required parameter.

401: Unauthorized

403: Unauthorized

Request samples


curl -L 'https://api.telnyx.com/v2/fax_applications' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Response samples


{
"data": [
{
"id": "1293384261075731499",
"record_type": "fax_application",
"application_name": "fax-router",
"active": false,
"anchorsite_override": "Amsterdam, Netherlands",
"webhook_event_url": "https://example.com",
"webhook_event_failover_url": "https://failover.example.com",
"webhook_timeout_secs": 25,
"inbound": {
"channel_limit": 10,
"sip_subdomain": "example",
"sip_subdomain_receive_settings": "only_my_connections"
},
"outbound": {
"channel_limit": 10,
"outbound_voice_profile_id": "1293384261075731499"
},
"created_at": "2018-02-02T22:25:27.521Z",
"updated_at": "2018-02-02T22:25:27.521Z"
}
],
"meta": {
"page_number": 2,
"page_size": 25,
"total_pages": 3,
"total_results": 55
}
}