Skip to main content
The Faxbeep API returns the tests shown on faxbeep.com as JSON. For an introduction and examples, see Developers.

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 no Accept header. A 422 response names the invalid parameter:
Common causes of a 422:
  • since is a date on its own (2026-10-01) or a time without an offset (2026-10-01T14:25:00). Add Z.
  • since has an unencoded + offset. Send +02:00 as %2B02:00, or use UTC with Z.
  • limit isn’t a whole number from 1 to 100.
  • from is longer than 255 characters, or is sent as an array (from[]=...).
Requests that use the default User-Agent of Python’s 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, has Cache-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.