GetDedicatedIp method

Written by

Updated at October 14, 2026

Returns information about a dedicated IP address in a folder. The folder is selected based on the service account the request originates from.

Request

GET /v2/email/dedicated-ips/{IP} HTTP/2

Parameter

Description

IP

Type: String.

Dedicated IP address.

{
  "DedicatedIp": {
    "Ip": "<IP_address>",
    "WarmupStatus": "DONE",
    "WarmupPercentage": 100,
    "PoolName": "<pool_name>"
  }
}

Parameter	Description
`Ip`	Type: String. Dedicated IP address.
`WarmupStatus`	Type: String. IP warm-up status. It always returns `DONE`.
`WarmupPercentage`	Type: Integer. IP warm-up completion percentage. It always returns `100`.
`PoolName`	Type: String. Name of the pool the IP address belongs to.

The 200 OK response may contain additional parameters. Its format may vary slightly from the above.

For all errors, the response body has the same format:

{
   "Code": "<error_name>",
   "message": "<error_description>"
}

The name of the error is taken from its code, e.g., BadRequestException.

The possible errors include:

Error code	Description
`400 BadRequestException`	The request contains invalid headers or parameters, or the `IP` parameter value is not a valid IP address.
`404 NotFoundException`	The IP address was not found or does not belong to your cloud.
`429 TooManyRequestsException`	The request quota was exceeded.