Skip to main content
GET
Get IP

Authorizations

X-Account-ApiKey
string
header
required

This api key can be used for all account level operations

Path Parameters

ip_id
integer
required

The unique ID of the IP resource to retrieve.

Example:

11322

Response

200 - application/json

Detailed information about the specified IP.

A dedicated IP address used for sending emails. Dedicated IPs give you full control over your sender reputation, as your deliverability is not affected by other senders.

IP Warmup: New IPs should be gradually "warmed up" by slowly increasing sending volume over 4-6 weeks to establish reputation with ISPs.

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