curl --request GET \
--url https://api.sendpost.io/api/v1/account/ip/ \
--header 'X-Account-ApiKey: <api-key>'import requests
url = "https://api.sendpost.io/api/v1/account/ip/"
headers = {"X-Account-ApiKey": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Account-ApiKey': '<api-key>'}};
fetch('https://api.sendpost.io/api/v1/account/ip/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sendpost.io/api/v1/account/ip/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Account-ApiKey: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sendpost.io/api/v1/account/ip/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Account-ApiKey", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sendpost.io/api/v1/account/ip/")
.header("X-Account-ApiKey", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sendpost.io/api/v1/account/ip/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Account-ApiKey"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": 11321,
"publicIp": "52.34.11.12",
"type": 1,
"autoWarmupEnabled": true,
"state": 1,
"created": 1567512491588018200
},
{
"id": 11322,
"publicIp": "34.21.14.11",
"type": 1,
"autoWarmupEnabled": true,
"state": 1,
"created": 1567512491588017700
}
]List IPs
Retrieve all IP addresses allocated to your account. IPs are the foundation of your sending infrastructure and directly impact deliverability.
IP Types:
| Type | Value | Description |
|---|---|---|
| Shared | 0 | IP shared with other SendPost senders. Cost-effective, reputation is pooled. |
| Dedicated | 1 | Exclusive IP for your account. Full control over sender reputation. |
IP States:
| State | Value | Description |
|---|---|---|
| Warmup | 0 | New IP building reputation. Volume is limited and gradually increases. |
| Normal | 1 | Fully warmed IP ready for normal sending volume. |
Warmup Information:
autoWarmupEnabled- Whether SendPost is automatically increasing volume
Use Cases:
- Monitor IP warmup progress for new IPs
- Audit shared vs dedicated IP allocation
- Plan IP pool configurations
- Check available sending capacity
curl --request GET \
--url https://api.sendpost.io/api/v1/account/ip/ \
--header 'X-Account-ApiKey: <api-key>'import requests
url = "https://api.sendpost.io/api/v1/account/ip/"
headers = {"X-Account-ApiKey": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Account-ApiKey': '<api-key>'}};
fetch('https://api.sendpost.io/api/v1/account/ip/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sendpost.io/api/v1/account/ip/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Account-ApiKey: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sendpost.io/api/v1/account/ip/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Account-ApiKey", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sendpost.io/api/v1/account/ip/")
.header("X-Account-ApiKey", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sendpost.io/api/v1/account/ip/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Account-ApiKey"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": 11321,
"publicIp": "52.34.11.12",
"type": 1,
"autoWarmupEnabled": true,
"state": 1,
"created": 1567512491588018200
},
{
"id": 11322,
"publicIp": "34.21.14.11",
"type": 1,
"autoWarmupEnabled": true,
"state": 1,
"created": 1567512491588017700
}
]Authorizations
This api key can be used for all account level operations
Query Parameters
Number of records to return per request. Default 20.
50
Number of initial records to skip for pagination.
0
Case insensitive search against public IP addresses.
"52.34"
Response
A list of IPs associated with the account
Unique identifier for the IP resource
11321
The public IPv4 address used for sending emails. This is the IP that receiving mail servers will see.
"52.34.11.12"
The reverse DNS (PTR record) hostname for this IP. Properly configured rDNS is important for deliverability. Format: sp{id}.{region}.sendpost.email
"sp11321.mtaspg.email"
Type of IP allocation:
0= Shared IP (shared with other SendPost senders, pooled reputation)1= Dedicated IP (exclusive to your account, your own reputation)
0, 1 1
Whether automatic IP warmup is enabled. When enabled, SendPost automatically manages sending volume to gradually build reputation on this IP.
true
Custom labels/tags for organizing IPs
Show child attributes
Show child attributes
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)
0, 1 1
UNIX epoch timestamp in nanoseconds when the IP was allocated
1704067200000000000
Was this page helpful?