---
title: "List all Faxes"
method: GET
path: "/Accounts/{AccountSid}/Faxes"
tags: ["Faxes"]
---

# List all Faxes

`GET /Accounts/{AccountSid}/Faxes`

List all faxes.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Fax_.

[Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).

## Path parameters

- `AccountSid` string, uuid, required

## Query parameters

- `Page` integer
- `PageSize` integer
- `PageToken` string
- `DateCreatedAfter` string
- `DateCreatedOnOrBefore` string
- `From` string
- `To` string

## Response `200`

The request has succeeded.

- FaxListResponse — Response containing a list of faxes.
  - `uri` string, required — The URI of the current page.
  - `first_page_uri` string, required — The URI of the first page.
  - `next_page_uri` string, nullable, required — The URI of the next page, or null if there are no more pages.
  - `previous_page_uri` string, nullable, required — The URI of the previous page, or null if this is the first page.
  - `page` integer, required — The current page number.
  - `page_size` integer, required — The number of items per page.
  - `faxes` Fax[], required — List of faxes.
    - `account_sid` string, required — The unique identifier for the account this fax is associated with.
    - `api_version` string, required — The version of the SignalWire API.
    - `date_created` string, required — The date and time, in ISO 8601 format, the fax was created.
    - `date_updated` string, required — The date and time, in ISO 8601 format, the fax was updated.
    - `direction` 'inbound' | 'outbound', required — Fax direction.
    - `from` string, required — The phone number, in E.164 format, the fax was sent from.
    - `media_url` string, nullable, required — The URL hosting the received media, or null if not available.
    - `media_sid` string, required — The unique identifier for the media instance associated with the fax instance.
    - `num_pages` string, nullable, required — The number of pages in the fax document, or null if not yet determined.
    - `price` string, nullable, required — The cost of the fax, or null if not yet calculated.
    - `price_unit` string, required — The currency, in ISO 4217 format, of the price.
    - `quality` 'standard' | 'fine' | 'superfine', required — Fax quality.
    - `sid` string, required — The unique identifier of the fax.
    - `status` 'queued' | 'processing' | 'sending' | 'delivered' | 'receiving' | 'received' | 'no-answer' | 'busy' | 'failed' | 'canceled', required — Fax status.
    - `to` string, required — The phone number, in E.164 format, the fax was sent to.
    - `duration` integer, required — The time, in seconds, it took to deliver a fax.
    - `links` FaxLinks, required — Fax links.
      - `media` string, required — Media associated with this fax.
    - `url` string, required — The URL of this resource.
    - `error_code` string, nullable, required — Error code for this resource, or null if no error.
    - `error_message` string, nullable, required — The description of this error, or null if no error.

## Other responses

- `400` — The request was invalid or cannot be processed. Check the error details for more information.
- `401` — Authentication failed. Please verify your credentials and try again.
- `422` — The request could not be processed due to validation errors. Check the error details for more information.

## Changes

- **2026-01-19** `d5fbaaddfa3e` — 5 breaking, 1 warning, 33 info
  - the response property `faxes/items/error_code` became nullable for the status `200`
  - the response property `faxes/items/error_message` became nullable for the status `200`
  - the response property `faxes/items/media_url` became nullable for the status `200`
  - the response property `faxes/items/num_pages` became nullable for the status `200`
  - …35 more
- **2026-01-15** `518ffc8751b7` — 6 warning, 1 info
  - removed the optional property `first_page_uri` from the response with the `200` status
  - removed the optional property `next_page_uri` from the response with the `200` status
  - removed the optional property `page` from the response with the `200` status
  - removed the optional property `page_size` from the response with the `200` status
  - …3 more
- **2026-01-15** `686ef84c2abc` — 1 breaking
  - the response property `previous_page_uri` became nullable for the status `200`
- **2026-01-15** `3c88f14db21e` — 4 breaking, 2 warning, 26 info
  - the `faxes/items/direction` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - the `faxes/items/links` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `faxes/items/quality` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - the `faxes/items/status` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - …28 more

[Change history](https://skmtc.dev/signalwire/apis/compatibility-api/changes/Accounts/:AccountSid/Faxes/get.md)

---

[API](https://skmtc.dev/signalwire/apis/compatibility-api.md) · [All operations](https://skmtc.dev/signalwire/apis/compatibility-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/signalwire/compatibility-api/revisions/8891278c1908/schema)
