Retrieves the list of in-flight IP address warmup statuses.
get/v3/ip_warmups
Retrieves a list of in-flight IP warmup statuses for dedicated IP addresses owned by the account. The response includes pagination URLs for navigating through the results.
SecuritybasicAuth
Request
Request samples
- curl
- Go
- Node.js
- PHP
- Java
- Python
- C#
- Ruby
Response samples
- 200
application/json
{- "items": [
- {
- "ip": "1.0.0.1",
- "sent_within_stage": "0%",
- "throttle": 78,
- "stage_number": 3,
- "stage_start_volume": 14000,
- "stage_start_time": "2025-01-01T00:00:00Z",
- "stage_volume_limit": 4000
}, - {
- "ip": "1.0.0.2",
- "sent_within_stage": "25%",
- "throttle": 90,
- "stage_number": 4,
- "stage_start_volume": 10000,
- "stage_start_time": "2025-01-01T00:00:00Z",
- "stage_volume_limit": 8000
}
], - "paging": {
- "first": "first",
- "next": "next"
}
}Retrieves the status of an in-flight IP warmup
get/v3/ip_warmups/{addr}
Retrieves the status of an in-flight IP warmup, which must be a dedicated IP owned by the account.
SecuritybasicAuth
Request
Request samples
- curl
- Go
- Node.js
- PHP
- Java
- Python
- C#
- Ruby
Response samples
- 200
application/json
{- "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": [
- {
- "first_updated_at": "0001-01-01T00:00:00Z",
- "completed_at": "2025-06-03T21:33:55.000000123Z",
- "limit": 1000
}, - {
- "first_updated_at": "0001-01-01T00:00:00Z",
- "completed_at": "2025-06-04T18:11:20.000000456Z",
- "limit": 2000
}, - {
- "first_updated_at": "0001-01-01T00:00:00Z",
- "completed_at": "2025-06-04T14:22:17.000000789Z",
- "limit": 4000
}
]
}
}