Skip to content Skip to navigation Skip to topbar

Retrieve all IP pools an IP address belongs to

API Overview

Elements that can be shared among more than one endpoint definition.

Operation overview

GET/v3/ips/{ip_address}

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

This endpoint allows you to see which IP pools a particular IP address has been added to.

The same IP address can be added to multiple IP pools.

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.

Operation details

Authentication

API Key

Headers

Property nameTypeRequiredDescription

Authorizationstringrequired

Default: Bearer <<YOUR_API_KEY_HERE>>

Path parameters

Property nameTypeRequiredDescription

ip_addressstringrequired

The IP address you are retrieving the IP pools for.

Responses

200

SchemaExample

Property nameTypeRequiredDescriptionChild properties

ipstring

The IP address.

subusersarray[string]

The subusers that can send email using this IP address.

rdnsstring

The reverse DNS record for this IP address.

poolsarray[string]

The list of IP pools that this IP address belongs to.

warmupboolean

Indicates if this IP address is currently warming up.

start_dateinteger or null

The date that the IP address was entered into warmup.

whitelabeledboolean

Indicates if this IP address is associated with a reverse DNS record.

Retrieve all IP pools an IP address belongs to

Node.js

Python

Java

PHP

Ruby

curl


_19const client = require('@sendgrid/client');
_19client.setApiKey(process.env.SENDGRID_API_KEY);
_19
_19const ip_address = "196.215.224.146";
_19
_19const request = {
_19  url: `/v3/ips/${ip_address}`,
_19  method: 'GET',
_19  
_19}
_19
_19client.request(request)
_19  .then(([response, body]) => {
_19    console.log(response.statusCode);
_19    console.log(response.body);
_19  })
_19  .catch(error => {
_19    console.error(error);
_19  });