Base URL
Endpoints
Responses have no
data wrapper: the list is a bare array, and a single test is a bare object.
List faxes and Get a fax describe each parameter and field, and include a playground for trying requests.
Rate limit
60 requests per minute per IPv4 address, or per IPv6 /64 block. Both endpoints share the same limit. Requests that return 404, 410, or 422 also count toward the rate limit.
When you receive a 429, wait the number of seconds in
Retry-After. To poll for a new test, see Test in CI.
Errors
Error responses are JSON, even when your client sends noAccept header.
A 422 response names the invalid parameter:
sinceis a date on its own (2026-10-01) or a time without an offset (2026-10-01T14:25:00). AddZ.sincehas an unencoded+offset. Send+02:00as%2B02:00, or use UTC withZ.limitisn’t a whole number from 1 to 100.fromis longer than 255 characters, or is sent as an array (from[]=...).
urllib module return 403 with a non-JSON body. Set your own User-Agent header, as the Python examples on these pages do.
Caching
Every response, including errors, hasCache-Control: no-store, private. Don’t cache responses: a new test can appear at any time.
Not available
- Webhooks or notifications. Poll the API until your test appears.
- Pagination or offsets. A single request returns at most 100 tests.
- Sending a fax, removing a test, or making a test private. To remove a test, see Remove a fax.
