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=Xreturns an empty array ([]). Setsinceto look further back, up to 30 days. - Encode parameter values.
sincemust be an ISO 8601 time with an offset, for example2026-10-01T14:25:00Z. A date on its own, or a time without an offset, returns 422. UTC withZneeds no encoding. Send each+, in a time offset or infrom, as%2B. The examples below let the HTTP client do the encoding.
Request examples
- By time
- By sender
- By email
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.[] 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_atis after the time you noted, and close to it.page_countmatches the number of pages you sent.sourceisphonefor a fax andemailfor an email test.fromis masked, as on faxbeep.com (see How sender details are displayed), so you can’t compare it with your full number.view_urlopens the test on faxbeep.com, where you can look at the page itself.pdf_urlandthumbnail_urllink to the files.
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.
