Skip to content
/
List account IPs

List account IPs

Request

assignable_to_pool in response lists which IPs can be assigned to DIPPs; this field is present only if the account has 'DIPPs' feature enabled.

total_count contains the number of items returned in items (this depends on the filters applied).

Security
basicAuth
Query
dedicatedboolean

Return only dedicated IPs

enabledboolean

Return only enabled IPs

curl -i -X GET \
  -u '<username>:<password>' \
  'https://api.mailgun.net/v3/ips?dedicated=true&enabled=true'

Responses

A 200 response

Bodyapplication/json
assignable_to_poolsArray of strings

list of IPs that can be assigned to dedicated IP pools.

detailsArray of objects(github.com-mailgun-tower-api-account-list_ips-detailsDocResponse)required

list of detailed information for each IP

itemsArray of stringsrequired

list of IPs

total_countinteger, (int32)required

total number of IPs for the given query

Response
{
  "assignable_to_pools": [
    "5.6.7.8"
  ],
  "details": [
    { … },
    { … }
  ],
  "items": [
    "1.2.3.4",
    "5.6.7.8"
  ],
  "total_count": 2
}