Skip to main content
GET
List IPs

Authorizations

X-Account-ApiKey
string
header
required

This api key can be used for all account level operations

Query Parameters

limit
integer
default:20

Number of records to return per request. Default 20.

Example:

50

offset
integer
default:0

Number of initial records to skip for pagination.

Example:

0

Case insensitive search against public IP addresses.

Example:

"52.34"

Response

200 - application/json

A list of IPs associated with the account

id
integer<int64>

Unique identifier for the IP resource

Example:

11321

publicIp
string<ipv4>

The public IPv4 address used for sending emails. This is the IP that receiving mail servers will see.

Example:

"52.34.11.12"

reverseDnsHostname
string

The reverse DNS (PTR record) hostname for this IP. Properly configured rDNS is important for deliverability. Format: sp{id}.{region}.sendpost.email

Example:

"sp11321.mtaspg.email"

type
enum<integer>

Type of IP allocation:

  • 0 = Shared IP (shared with other SendPost senders, pooled reputation)
  • 1 = Dedicated IP (exclusive to your account, your own reputation)
Available options:
0,
1
Example:

1

autoWarmupEnabled
boolean

Whether automatic IP warmup is enabled. When enabled, SendPost automatically manages sending volume to gradually build reputation on this IP.

Example:

true

labels
object[]

Custom labels/tags for organizing IPs

state
enum<integer>

Current state of the IP:

  • 0 = Warmup (IP is in warmup phase, gradually building reputation)
  • 1 = Normal (IP is fully warmed and ready for full sending volume)
Available options:
0,
1
Example:

1

created
integer<int64>

UNIX epoch timestamp in nanoseconds when the IP was allocated

Example:

1704067200000000000