Count the emails that arrived
How many emails reached the address since since, for checks such as "exactly one verification email". Doesn't wait. Each email is summarised by when it arrived, its sender and the kind of its main code or link, never its content. Count after the wait for the first email has returned, so a duplicate has time to arrive.
Request
- Base URL: https://api.proxymail.qa
- URL: https://api.proxymail.qa/v1/addresses/{address}/count
- Auth: HTTP bearer
Path parameters
The test address, URL-encoded. A variant also works: capitals, or a +tag (k7f2x9ab12cd+o'brien@mailclub.dev). It acts on the plain address; waiting on a +tag variant, or listing its messages, only finds mail sent to that variant.
Query parameters
Only email received at or after this time. Default: every email the address has received.
Only email from this service, by name or domain (e.g. 'spotify').
Only emails with a code, or with a link. Codes leave out coupons, and links count verify, magic_signin, invite and reset, unless subtype says otherwise.
With type, comma-separated: otp or coupon for codes; verify, magic_signin, invite, reset or other for links; or any.
Headers
A run's id (POST /v1/runs): adds what this call saw to the run. If it can't be added (the run finished, or isn't in this project), the call still works and the Proxy-Mail-QA-Run-Warning response header says why.
With Proxy-Mail-QA-Run: the test this call belongs to, percent-encoded (encodeURIComponent), up to 200 characters once decoded. The run's report shows it beside what the call saw.
Response
The count
Changes
No recorded changes to this operation across all 1 revision of this API.