Skip to content
/
Retrieves the status of a...

Retrieves the status of an in-flight IP warmup

Request

Retrieves the status of an in-flight IP warmup, which must be a dedicated IP owned by the account.

Security
basicAuth
Path
addrstringrequired

The IP address to retrieve the warmup status for.

curl -i -X GET \
  -u '<username>:<password>' \
  'https://api.mailgun.net/v3/ip_warmups/{addr}'

Responses

A 200 response

Bodyapplication/json
messagestringrequired

Response message

Response
{
  "details": {
    "sent_within_stage": "20%",
    "throttle": 78,
    "start_volume": 10000,
    "stage": 2,
    "stage_limit": 4000,
    "hourly_limit": 100,
    "stage_started_at": "2025-01-01T00:00:00Z",
    "hour_started_at": "2025-01-01T00:00:00Z",
    "plan_started_at": "2025-01-01T00:00:00Z",
    "plan_last_updated_at": "2025-01-01T00:00:00Z",
    "total_stages": 15,
    "stage_history": [ … ]
  }
}