Retrieve all IP addresses

GET https://api.sendgrid.com/v3/ips?ip={{ip}}&exclude_whitelabels={{exclude_whitelabels}}&limit=10&offset=0&subuser={{subuser}}&sort_by_direction={{sort_by_direction}}

This endpoint allows you to retrieve a list of all assigned and unassigned IPs.

Response includes warm up status, pools, assigned subusers, and whitelabel info. The start_date field corresponds to when warmup started for that IP.

A single IP address or a range of IP addresses may be dedicated to an account in order to send email for multiple domains. The reputation of this IP is based on the aggregate performance of all the senders who use it.

Request Params

KeyDatatypeRequiredDescription
ipstring
exclude_whitelabelsstring
limitnumber
offsetnumber
subuserstring
sort_by_directionstring

HEADERS

KeyDatatypeRequiredDescription
Acceptstring