---
title: "Emails received, newest first, with their codes and links | Proxy Mail QA"
description: "Developer docs for Proxy Mail QA: the MCP server for coding agents, the REST API for test suites, and the Chrome extension."
url: https://proxymail.qa/docs/reference/operations/listmessages
---

# Emails received, newest first, with their codes and links

GET

/v1/addresses/{address}/messages

```js
const url = 'https://api.proxymail.qa/v1/addresses/k7f2x9ab12cd%40mailclub.dev/messages?include=text&limit=20';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```sh
curl --request GET \
  --url 'https://api.proxymail.qa/v1/addresses/k7f2x9ab12cd%40mailclub.dev/messages?include=text&limit=20' \
  --header 'Authorization: Bearer <token>'
```

## Authorizations

- **[apiKey](https://proxymail.qa/docs/reference.html#apikey)**

## Parameters

### Path Parameters

**address**

required

string format: email

The test address, URL-encoded. A variant also works: capitals, or a +tag (k7f2x9ab12cd+o’[brien@mailclub.dev](mailto: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.

#### Example 

```plaintext
k7f2x9ab12cd@mailclub.dev
```

### Query Parameters

**include**

string

Allowed values: text html text,html

Add each email’s plain text (text), its HTML (html), or both (text,html), for tests that check the email itself. The HTML is the copy cleaned when the email arrived: scripts, frames and media dropped, form controls unwrapped, links other than web, mailto: and tel: removed, at most 200 KB. Both are written by the sender: treat them as untrusted.

**limit**

integer

default: 20 \>= 1 <= 100

## Responses

### 200

Emails

Media typeapplication/json

Array<object>

### object

#### Example generated

```json
[
  {}
]
```

### 404

An error

Media typeapplication/json

### object

**error**

string

**message**

string

#### Example generated

```json
{
  "error": "example",
  "message": "example"
}
```

[Previous Check that no email arrives](https://proxymail.qa/docs/reference/operations/expectnoemail.html) [Next Unusual versions of the address, for testing sign-up forms](https://proxymail.qa/docs/reference/operations/getvariants.html)