> ## Documentation Index > Fetch the complete documentation index at: https://faxbeep.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List faxes > Faxes, newest first, by phone and by email together. With no `since`, the list covers the last 24 hours. There is no offset and no paging: a call gives 100 faxes at most. `?from=X&limit=1` gives the latest fax of a sender. ## OpenAPI ````yaml /openapi.json get /api/faxes openapi: 3.1.0 info: title: Faxbeep API version: 1.0.0 description: >- Read-only JSON for the test faxes that faxbeep.com shows. No account and no token. Each fax is public for 30 days. The limits in this file (60 requests each minute, 100 faxes for each call, a default of 20, a default window of 24 hours) are also variables in docs.json: change both. servers: - url: https://faxbeep.com security: [] tags: - name: Faxes description: Test faxes and scans, newest first. paths: /api/faxes: get: tags: - Faxes summary: List faxes description: >- Faxes, newest first, by phone and by email together. With no `since`, the list covers the last 24 hours. There is no offset and no paging: a call gives 100 faxes at most. `?from=X&limit=1` gives the latest fax of a sender. operationId: listFaxes parameters: - name: limit in: query required: false description: How many faxes to return. From 1 to 100. schema: type: integer minimum: 1 maximum: 100 default: 20 example: 20 - name: since in: query required: false description: >- Only faxes received strictly later than this time, to the second. ISO 8601 with an offset: `2026-10-01T14:25:00Z` or `2026-10-01T16:25:00+02:00`. A date alone, or a time with no offset, answers 422. Use UTC with `Z`. Send the `+` of an offset as `%2B`. Default: 24 hours ago. schema: type: string format: date-time example: '2026-10-01T14:25:00Z' - name: from in: query required: false description: >- Only faxes of this sender: the full phone number, station ID or email address, not the masked form. Case does not matter. A station ID matches with or without spaces. A number matches with or without its `+`. No prefix and no wildcard. `Unknown` gives the faxes with no sender ID. Send a `+` as `%2B`. 255 characters at most. schema: type: string maxLength: 255 example: '+15555550123' responses: '200': description: >- A JSON array of faxes, newest first. An empty array (`[]`) when no fax matches. headers: Cache-Control: $ref: '#/components/headers/CacheControl' X-RateLimit-Limit: $ref: '#/components/headers/XRateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/XRateLimitRemaining' content: application/json: schema: type: array items: $ref: '#/components/schemas/Fax' example: - slug: fax_5dd79a1c source: phone from: +155*****123 received_at: '2026-10-01T14:30:00Z' page_count: 3 file_size: 245678 pdf_url: https://cdn.faxbeep.com/faxes/fax_5dd79a1c.pdf thumbnail_url: https://cdn.faxbeep.com/faxes/fax_5dd79a1c-thumb.jpg view_url: https://faxbeep.com/faxtest/fax_5dd79a1c - slug: fax_a3f0c2e7 source: email from: s***@e***.com received_at: '2026-10-01T14:27:12Z' page_count: 1 file_size: 98304 pdf_url: https://cdn.faxbeep.com/faxes/fax_a3f0c2e7.pdf thumbnail_url: https://cdn.faxbeep.com/faxes/fax_a3f0c2e7-thumb.jpg view_url: https://faxbeep.com/faxtest/fax_a3f0c2e7 - slug: fax_7b21e9d4 source: phone from: null received_at: '2026-10-01T14:26:45Z' page_count: 2 file_size: 187220 pdf_url: https://cdn.faxbeep.com/faxes/fax_7b21e9d4.pdf thumbnail_url: https://cdn.faxbeep.com/faxes/fax_7b21e9d4-thumb.jpg view_url: https://faxbeep.com/faxtest/fax_7b21e9d4 '422': $ref: '#/components/responses/ValidationError' '429': $ref: '#/components/responses/TooManyRequests' components: headers: CacheControl: description: Always `no-store, private`. Do not cache an answer. schema: type: string XRateLimitLimit: description: 'Requests allowed each minute: 60.' schema: type: integer XRateLimitRemaining: description: Requests left in the current minute. schema: type: integer schemas: Fax: type: object description: A test fax or scan, as faxbeep.com shows it. The sender is masked. required: - slug - source - from - received_at - page_count - file_size - pdf_url - thumbnail_url - view_url properties: slug: type: string description: The ID of the fax. Use it with `GET /api/faxes/{slug}`. example: fax_5dd79a1c source: type: string enum: - phone - email description: >- `phone` for a fax by phone, `email` for a scan to email test or an Internet Fax test. example: phone from: type: - string - 'null' description: >- The sender, masked as on faxbeep.com: a number loses its middle 5 digits, an address shows as `s***@e***.com`. A station ID with fewer than 6 digits shows as it is. `null` when the fax arrived with no sender ID (shown as Unknown on the site). example: +155*****123 received_at: type: string format: date-time description: >- The time the fax arrived, in UTC with `Z`. This is the time that `since` compares. A fax appears in the API later, when its processing is done. example: '2026-10-01T14:30:00Z' page_count: type: - integer - 'null' description: The number of pages. `null` if the fax could not be processed. example: 3 file_size: type: - integer - 'null' description: >- The size of the PDF, in bytes. `null` if the fax could not be processed. example: 245678 pdf_url: type: - string - 'null' format: uri description: The PDF of the fax. `null` if the fax could not be processed. example: https://cdn.faxbeep.com/faxes/fax_5dd79a1c.pdf thumbnail_url: type: - string - 'null' format: uri description: >- An image of the first page. `null` if the fax could not be processed. example: https://cdn.faxbeep.com/faxes/fax_5dd79a1c-thumb.jpg view_url: type: string format: uri description: The page of the fax on faxbeep.com. example: https://faxbeep.com/faxtest/fax_5dd79a1c ValidationError: type: object required: - message - errors properties: message: type: string description: The first error. errors: type: object description: For each parameter that is not valid, a list of messages. additionalProperties: type: array items: type: string Error: type: object required: - message properties: message: type: string description: A short text. Empty for 404 and 410. responses: ValidationError: description: >- A parameter is not valid: `limit` out of range, `since` with no offset or not a time, `from` too long or sent as an array. headers: Cache-Control: $ref: '#/components/headers/CacheControl' content: application/json: schema: $ref: '#/components/schemas/ValidationError' example: message: The since field format is invalid. errors: since: - The since field format is invalid. TooManyRequests: description: >- The rate limit is used up: 60 requests each minute for one IPv4 address or one IPv6 /64 block. Wait the number of seconds in `Retry-After`. headers: Retry-After: description: Seconds to wait before the next request. schema: type: integer X-RateLimit-Limit: $ref: '#/components/headers/XRateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/XRateLimitRemaining' X-RateLimit-Reset: description: The time when requests are allowed again, as a Unix timestamp. schema: type: integer Cache-Control: $ref: '#/components/headers/CacheControl' content: application/json: schema: $ref: '#/components/schemas/Error' example: message: Too Many Attempts. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.