---
title: "API changelog · Proxy Mail QA"
description: "Every update to Proxy Mail QA’s API, newest first. The REST API for test scripts, CI and agents."
url: https://proxymail.qa/changelog/api
---

[Changelog](https://proxymail.qa/changelog)

# What’s new: API

The REST API for test scripts, CI and agents. Every update to it, newest first.

[Follow by RSS](https://proxymail.qa/changelog.xml) [Service status](https://proxymailqa.statuspage.io)

[All](https://proxymail.qa/changelog) [App](https://proxymail.qa/changelog/app) [API](https://proxymail.qa/changelog/api) [MCP server](https://proxymail.qa/changelog/mcp) [npm package](https://proxymail.qa/changelog/npm) [Chrome extension](https://proxymail.qa/changelog/extension) [Marketplaces](https://proxymail.qa/changelog/marketplaces) [Docs](https://proxymail.qa/changelog/docs)

1. 17 October 2026  
## [Runs, email checks and a Reports dashboard](https://proxymail.qa/changelog#2026-10-17)

  - NewEmail checks: `GET /v1/addresses/{address}/checks` checks an email's SPF, DKIM and DMARC, links to localhost or plain http, where its link goes, a stated expiry, a plain-text part, size and image-only emails. Verdicts only, never the email's content.
  - NewRuns: start one with `POST /v1/runs` and send its id in the `Proxy-Mail-QA-Run` header; each call adds what it saw. `GET /v1/runs/{id}?format=markdown` is the report for a pull request.
  - NewWaits take `unused=true` to skip a code or link already used.
  - NewAn account pool for parallel tests: `POST /v1/addresses/checkout` holds an account matching your filters (tags for its state, country, age, saved password) that no other test has, until you return it or its time runs out. Returning can record its new state.
  - NewValues for a sign-up form: `POST /v1/form-values` takes what the page says about each field and answers with what to type or pick in each, from a new address made for the form: a username and password that fit the field's rules, the date of birth in its format, and a country its drop-down offers. You still fill in the form.
  - ImprovedEmail checks take `expect_text`, phrases the subject or body should contain, and `expect_language`, the language it should be in. They also warn when an email may not fit a phone: parts too wide, images without alt text, or tiny text. Verdicts only, never the email's words.
  - NewRuns say which test each email came from (the `Proxy-Mail-QA-Test` header) and take test results (`POST /v1/runs/{id}/tests`). `GET /v1/runs/{id}` compares the run with the last runs of the same name.  
[The whole update →](https://proxymail.qa/changelog#2026-10-17)
2. 15 October 2026  
## [The Team plan, new MCP tools and the npm package](https://proxymail.qa/changelog#2026-10-15)

  - New`GET /v1/addresses/{address}/variants` lists unusual versions of an address for testing sign-up forms (capitals, plus tags with special characters, the longest name allowed), and every endpoint accepts them. See [unusual email addresses](https://proxymail.qa/docs/unusual-addresses).
  - NewFind test accounts you made earlier: `GET /v1/addresses` filters by tag, country, age, saved password or text.
  - New`/count` counts the emails that reached an address, and `/none` checks that none arrive, for testing emails that shouldn't be sent.
  - New`include=html` on the messages endpoint returns each email's HTML, cleaned, for template tests.
  - ImprovedSafer agent sign-in. A sign-in token used twice ends that sign-in, as a copy must be in use, and apps on your computer can sign in on any local port.  
[The whole update →](https://proxymail.qa/changelog#2026-10-15)
3. 13 October 2026  
## [See why an email didn't arrive](https://proxymail.qa/changelog#2026-10-13)

  - New`GET /v1/addresses/{address}/delivery` checks an address without waiting, and a wait that finds nothing now says why: mail we refused, or that nothing has reached the address yet.  
[The whole update →](https://proxymail.qa/changelog#2026-10-13)
4. 12 October 2026  
## [A REST API and an MCP server for tests and AI agents](https://proxymail.qa/changelog#2026-10-12)

  - NewThe REST API at `api.proxymail.qa/v1` creates, lists, updates and deletes addresses, and waits up to 30 seconds for a code or link. Create keys in Project settings → API keys. See the [REST API docs](https://proxymail.qa/docs/rest-api).  
[The whole update →](https://proxymail.qa/changelog#2026-10-12)