Skip to the documentation
API

List dedicated IPs

The IP addresses only this workspace sends from, and how far their warm-up is.

GET/sending/dedicated-ips

Runs any of 2 calls on your workspace.

GET /sending/dedicated-ips

The IP addresses only this workspace sends from, and how far their warm-up is.

Example

Needs domains:read. A dedicated IP is an add-on, bought with POST /billing/add-ons/checkout. A new IP is warmed up over several weeks: warmupPercent says how far it is, and until it reaches 100 part of the mail still leaves through the shared IPs. A workspace without the add-on gets an empty list.

curl
curl "$OE/sending/dedicated-ips" -H "$AUTH"
Response
{ "object": "list", "data": [{  "object": "dedicated_ip",  "ip": "203.0.113.24",  "status": "warming",  "pool": "oe-ws-4f2a91c7",  "poolStatus": "warming",  "warmupPercent": 35,  "assignedAt": "2026-10-02T08:12:00.000Z",  "readyAt": null,  "checkedAt": "2026-10-11T09:40:00.000Z"}] }

GET /sending/dedicated-ips/{ip} reads one of them. An IP that does not belong to the workspace is a 404 resource_not_found.

Reference