Sidebar

Create IP Address API

POST /ips

Creates a new IP address record for the current user. The IP address is automatically detected from the request.

Query Parameters

Name Type Description
apikey string Your API key

Authentication

This endpoint requires authentication via Bearer token or API key in query string.


Example Request

curl -X POST "https://dnsprivacy.org.uk/ips" \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer <your-access-token>'

Example Response

{
  "id": 1,
  "address": "192.168.0.1",
  "active": true,
  "cidr": 32,
  "ipv4": true,
  "ipv6": false,
  "first": "192.168.0.1",
  "last": "192.168.0.1"
}

Response Schema

Field Type Description
id integer Unique identifier for this IP record
address string IP address in string format
active boolean Whether this IP is currently active
cidr integer CIDR notation (e.g., 32 for single IPv4, 128 for IPv6)
ipv4 boolean Whether this is an IPv4 address
ipv6 boolean Whether this is an IPv6 address
first string First IP in range (same as address for single IPs)
last string Last IP in range (same as address for single IPs)

Our use of cookies
We use a session cookie to maintain your login state when you create an account with us. This cookie is essential for the operation of our website and is used solely for authentication purposes. For more information, please read our privacy policy.