Skip to main content
GET /api/faxes returns recent tests from everyone. How you pick out yours depends on what reaches Faxbeep with your test. A test appears in the API once processing finishes, usually within a minute after the call ends or after your machine sends the email.

Time window and URL encoding

  • Without since, the response covers only the last 24 hours. If the most recent test from a sender is older, ?from=X returns an empty array ([]). Set since to look further back, up to 30 days.
  • Encode parameter values. since must be an ISO 8601 time with an offset, for example 2026-10-01T14:25:00Z. A date on its own, or a time without an offset, returns 422. UTC with Z needs no encoding. Send each +, in a time offset or in from, as %2B. The examples below let the HTTP client do the encoding.

Request examples

Note the time just before you send the test, then request the tests that arrived after it. Other people send tests at the same time, so compare page_count and received_at with what you sent.
Each request returns a JSON array, newest first, or [] if no test matches. List faxes describes each field.

Check the candidates

These checks narrow the results to likely candidates. Another person’s test can pass them too, so none of them proves that a test is yours.
  • received_at is after the time you noted, and close to it.
  • page_count matches the number of pages you sent.
  • source is phone for a fax and email for an email test.
  • from is masked, as on faxbeep.com (see How sender details are displayed), so you can’t compare it with your full number.
  • view_url opens the test on faxbeep.com, where you can look at the page itself. pdf_url and thumbnail_url link to the files.
To fetch the same test again later, request GET /api/faxes/{slug} with its slug. After 30 days, or once the test is removed, it returns 410.
Don’t use the newest received_at you have seen as your next since. received_at is the arrival time, and a long fax can appear in the API after a newer, shorter one. Keep since at the time you noted until your test appears.

Next steps

Station ID

When filtering by sender works for a fax, and when a sender ID is shared.

Test in CI

Poll for your fax from a script, with a timeout.