List Dedicated Ips

List Dedicated IPs

GET /v1/dedicated-ips

List the dedicated IPs allocated to the calling user's account. A dedicated IP is an unshared IPv4 address you can attach to one endpoint at a time, useful for customer firewall allow-lists, dedicated reputation, or compliance requirements that demand "non-shared infrastructure".

Account scope: these IPs are allocated to your active account and shared with its members per your role's permissions. Use switch account to view a different account's IPs.

Provisioning is async — request via POST /v1/requests, wait for fulfilment, then attach via POST /v1/endpoints/{id}/dedicated-ip. To release one back to the pool, use POST /v1/{id}/release.

Maximum 6 dedicated IPs per account (platform constant). Cross-reference this list with /dedicated-ips/attachments to see which endpoints currently use which IPs.

This endpoint lists individual single-mode assignments. An assignment may also be a member of a geo-routed per-region group — see GET /v1/dedicated-ips/groups. An IP parked in standby (reserved after a plan downgrade) may also appear here until it is reattached or freed.

Response (200 OK)

JSON object with an items array of allocated IPs:

id int64

Numeric ID. Used in attach/release endpoints.

ip_address string

The actual IPv4 address (203.0.113.5).

region_slug string

Region this IP lives in. Endpoints can only attach IPs in the same region.

status string

Assignment status. This list only returns active assignments.

stripe_subscription_item_id string

Stripe subscription item ID backing the IP's recurring charge. Omitted when not billed through Stripe.

endpoint_count int

Number of endpoints currently attached to this IP.

assigned_at datetime

When the IP was assigned to the account. RFC 3339 UTC.

Errors

401 Unauthorized

Missing auth.

Request
curl "https://api.ngris.com/v1/dedicated-ips" \
  -H "X-API-KEY: <your_api_key>"

Python
from ngris import Ngris

client = Ngris(api_key="<your_api_key>")
for ip in client.dedicated_ips.list()["items"]:
    print(f"{ip['ip_address']:<16} {ip['region_slug']:<12} {ip['endpoint_count']} endpoint(s)")

Response — 200 OK
{
  "items": [
    {
      "id": 7,
      "ip_address": "203.0.113.5",
      "region_slug": "eu-north-1",
      "status": "active",
      "stripe_subscription_item_id": "si_abc123",
      "endpoint_count": 1,
      "assigned_at": "2026-04-15T00:00:00Z"
    }
  ]
}

PreviousDelete Client CA NextList Dedicated IP Requests

On this page

List Dedicated IPs