Dedicated IPsList dedicated IPs

List dedicated IPs

curl -X GET "https://api.supasend.io/v1/ips" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY"
[
  {
    "id": "example_string",
    "ip_address": "203.0.113.45",
    "region": "EU",
    "business_name": "Acme Mailer",
    "status": "provisioning",
    "is_default": true,
    "monthly_price_cents": 2000
  }
]
GET
/v1/ips
GET
Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: X-API-Key)
X-API-Keystring
Required

API key in the format sk_live_<64 hex characters>

API key in the format sk_live_<64 hex characters>
Request Preview
Response

Response will appear here after sending the request

Authentication

header
X-API-Keystring
Required

API Key for authentication. API key in the format sk_live_\<64 hex characters\>

Responses

idstring
ip_addressstring
regionstring
Allowed values:EUUS
business_namestring
statusstring

active — usable for sends. suspended — monthly charge could not be covered; top up the wallet to restore it. Other states are transitional while the SupaSend team provisions or releases the IP.

Allowed values:provisioningactivereleasingreleasedsuspended
is_defaultboolean

When true, this IP is used for any send that omits ip_id. Each account has exactly one default IP at a time; the first IP assigned to your account is auto-promoted to default.

monthly_price_centsinteger