---
title: "GET /v1/email/dedicated-ips"
method: GET
path: "/v1/email/dedicated-ips"
---

# GET /v1/email/dedicated-ips

`GET /v1/email/dedicated-ips`

List the dedicated IP addresses that are associated with your Amazon Pinpoint account.

## Query parameters

- `PoolName` string — The name of a dedicated IP pool.
- `NextToken` string
- `PageSize` integer

## Response `200`

Success

- GetDedicatedIpsResponse — Information about the dedicated IP addresses that are associated with your Amazon Pinpoint account.
  - `DedicatedIps` DedicatedIp[] — A list of dedicated IP addresses that are reserved for use by your Amazon Pinpoint account.
    - `Ip` string, required — An IP address that is reserved for use by your Amazon Pinpoint account.
    - `WarmupStatus` 'IN_PROGRESS' | 'DONE', required — <p>The warm-up status of a dedicated IP address. The status can have one of the following values:</p> <ul> <li> <p> <code>IN_PROGRESS</code> – The IP address isn't ready to use because the dedicated IP warm-up process is ongoing.</p> </li> <li> <p> <code>DONE</code> – The dedicated IP warm-up process is complete, and the IP address is ready to use.</p> </li> </ul>
    - `WarmupPercentage` integer, required — Indicates how complete the dedicated IP warm-up process is. When this value equals 1, the address has completed the warm-up process and is ready for use.
    - `PoolName` string — The name of the dedicated IP pool that the IP address is associated with.
  - `NextToken` string — A token that indicates that there are additional dedicated IP addresses to list. To view additional addresses, issue another request to <code>GetDedicatedIps</code>, passing this token in the <code>NextToken</code> parameter.

## Other responses

- `480` — TooManyRequestsException
- `481` — NotFoundException
- `482` — BadRequestException

---

[API](https://skmtc.net/aws/apis/pinpoint-email.md) · [All operations](https://skmtc.net/aws/apis/pinpoint-email/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/pinpoint-email/versions/73704a3e0b47/schema)