---
title: "Reveal a saved test password | 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/revealpassword
---

# Reveal a saved test password

GET

/v1/addresses/{address}/password

```js
const url = 'https://api.proxymail.qa/v1/addresses/k7f2x9ab12cd%40mailclub.dev/password?label=password';
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/password?label=password' \
  --header 'Authorization: Bearer <token>'
```

Only for keys created with “Can read saved passwords”. Every reveal is logged.

## 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

**label**

string

default: password

## Responses

### 200

The secret

Media typeapplication/json

### object

**address**

string

**label**

string

**secret**

string

#### Example generated

```json
{
  "address": "example",
  "label": "example",
  "secret": "example"
}
```

### 403

An error

Media typeapplication/json

### object

**error**

string

**message**

string

#### Example generated

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

### 404

An error

Media typeapplication/json

### object

**error**

string

**message**

string

#### Example generated

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

[Previous Check why mail is or isn't arriving](https://proxymail.qa/docs/reference/operations/checkdelivery.html) [Next Save a new test password](https://proxymail.qa/docs/reference/operations/setpassword.html)