Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

Retrieve all IPs currently in warmup



API Overview

api-overview page anchor

IP warming is the practice of gradually increasing the volume of mail sent with a dedicated IP address according to a predetermined schedule. This gradual process helps to establish a reputation with ISPs (Internet Service Providers) as a legitimate email sender.

SendGrid can automatically warm up dedicated IP addresses by limiting the amount of mail that can be sent through them per hour. The limit determined by how long the IP address has been warming up.

See the warmup schedule to learn how SendGrid limits your email traffic for IPs in warmup.

You can also choose to use Twilio SendGrid's automated IP warmup for any of your IPs from the "IP Addresses" settings menu in the Twilio SendGrid App(link takes you to an external page).


GET/v3/ips/warmup

Base url: https://api.sendgrid.com

This endpoint allows you to retrieve all of your IP addresses that are currently warming up.


Authentication

authentication page anchor
Authorizationstringrequired
Default: Bearer <<YOUR_API_KEY_HERE>>
200
SchemaExample

Array of:

ipstring

The IP address.


start_dateinteger

A Unix timestamp indicating when the IP address entered warmup mode.

Retrieve all IPs currently in warmup

retrieve-all-ips-currently-in-warmup page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
curl

_18
const client = require('@sendgrid/client');
_18
client.setApiKey(process.env.SENDGRID_API_KEY);
_18
_18
_18
const request = {
_18
url: `/v3/ips/warmup`,
_18
method: 'GET',
_18
_18
}
_18
_18
client.request(request)
_18
.then(([response, body]) => {
_18
console.log(response.statusCode);
_18
console.log(response.body);
_18
})
_18
.catch(error => {
_18
console.error(error);
_18
});


Rate this page: