---
title: "List or find addresses in the project, newest first"
method: GET
path: "/v1/addresses"
---

# List or find addresses in the project, newest first

`GET /v1/addresses`

## Request

- Base URL: `https://api.proxymail.qa`
- URL: `https://api.proxymail.qa/v1/addresses`
- Auth: HTTP bearer

Every filter given must match, so an agent or test can find a test account it made earlier, such as an under-18 in GB with a saved password: ?tag=age-gate&country=GB&max_age=17&has_password=true.

## Query parameters

- `limit` integer
- `before` string, date-time
- `tag` string[]
- `country` string
- `min_age` integer
- `max_age` integer
- `has_password` boolean
- `search` string
- `site` string
- `environment` string

## Response `200`

Addresses

- Address[]
  - `address` string
  - `label` string, nullable
  - `created_at` string, date-time
  - `expires_at` string, date-time
  - `persona` object, nullable
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `username` string, nullable
    - `date_of_birth` string, date: Present only when the address has one.
    - `country` string: ISO 3166-1 alpha-2 code, such as GB. Present only when the address has one.
  - `notes` string, nullable
  - `tags` string[]
  - `has_password` boolean
  - `password` string: Only in the response to creating it with password: true.
  - `site` string: Where it is used: the host of the app under test. Present only when set.
  - `environment` string: Which environment it is used in, such as staging. Present only when set.
  - `email_count` integer
  - `latest` object, nullable: The newest code or link, like Match.
  - `checked_out_until` string, date-time: Only while someone has it checked out of the pool.

## Other responses

- `401`: An error

---

[API](https://skmtc.dev/proxymail/apis/proxy-mail-qa-api.md) · [All operations](https://skmtc.dev/proxymail/apis/proxy-mail-qa-api/llms.txt) · [OpenAPI document](https://skmtc.dev/proxymail/apis/proxy-mail-qa-api/revisions/8f8a5e84cf5c?raw)