Dedicated IP Attachments
Compact map of "which IP is attached to which endpoint". Useful when you want a single view of all your dedicated IPs and their current bindings without joining /dedicated-ips with /endpoints manually.
Includes only currently-active attachments. Released or never-attached IPs aren't here — use /dedicated-ips for the full lifecycle view.
Response (200 OK)
items array
Active
(IP, endpoint) bindings. Each: {endpoint_uuid, subdomain, domain_name, assignment_uuid, ip_address, ip_region, assigned_at}. assignment_uuid is the IP assignment's uuid from /dedicated-ips.Deprecated: until the sunset this response also carries the legacy integer id and *_id fields. Don't use them; read uuid and the *_uuid fields.
Errors
401 Unauthorized
Missing auth.
Request
curl "https://api.ngris.com/v1/dedicated-ips/attachments" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
result = client._get_raw("/dedicated-ips/attachments")
for a in result["items"]:
print(f"{a['ip_address']:<16} -> {a['subdomain']}.{a['domain_name']}")
Response — 200 OK
{
"items": [
{
"endpoint_uuid": "019bb1e4-e785-77d2-9966-c3cff31d0a0e",
"subdomain": "myapp",
"domain_name": "ngris.io",
"assignment_uuid": "019b230b-86f2-701a-8001-a15a433823c1",
"ip_address": "203.0.113.5",
"ip_region": "eu-fi",
"assigned_at": "2026-04-15T00:00:00Z"
}
]
}
Was this helpful?