Skip to content Skip to navigation Skip to topbar

Retrieve all assigned IPs

API Overview

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

Operation overview

GET/v3/ips/assigned

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

This endpoint allows you to retrieve only assigned IP addresses.

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>>

Responses

200

SchemaExample

Array of:

Property nameTypeRequiredDescriptionChild properties

ipstring

The IP address.

poolsarray[string]

The IP pools that this IP address has been added to.

warmupboolean

Indicates if this IP address is currently warming up.

start_dateinteger

The start date that this IP address was entered into warmup.

Retrieve all assigned IPs

Node.js

Python

Java

PHP

Ruby

curl


_18const client = require('@sendgrid/client');
_18client.setApiKey(process.env.SENDGRID_API_KEY);
_18
_18
_18const request = {
_18  url: `/v3/ips/assigned`,
_18  method: 'GET',
_18  
_18}
_18
_18client.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  });