Get assigned IP addresses for your account

Get an overview of all IP addresses associated with your account. It also returns a unique ID needed for follow-up actions or identifying specific resources in other API calls. Use this information to manage and understand your network configuration.

Headers

Accept Example

Content-Type Example

Responses

200

success boolean

timestamp string

requestId string

data object

GET https://cloud.hostup.se/api/client-ips

For AI assistants

cURL

curl -X GET "https://cloud.hostup.se/api/client-ips" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "success": true,
  "timestamp": "string",
  "requestId": "string",
  "data": {
    "ips": [
      {
        "id": "string",
        "address": "string",
        "type": "string",
        "subnet": "string",
        "subnet_id": "string",
        "rdns": "string",
        "mac": "string",
        "status": "string",
        "account_id": "string",
        "assigned_date": "string",
        "description": "string"
      }
    ],
    "subnets": [
      "string"
    ],
    "summary": {
      "total_ips": 0,
      "ipv4_count": 0,
      "ipv6_count": 0,
      "allocated_count": 0,
      "available_count": 0,
      "subnet_count": 0
    }
  }
}

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "timestamp": {
      "type": "string"
    },
    "requestId": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "properties": {
        "ips": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "address": {
                "type": "string"
              },
              "type": {
                "type": "string"
              },
              "subnet": {
                "type": "string"
              },
              "subnet_id": {
                "type": "string"
              },
              "rdns": {
                "type": "string"
              },
              "mac": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "account_id": {
                "type": "string"
              },
              "assigned_date": {
                "type": "string"
              },
              "description": {
                "type": "string"
              }
            }
          }
        },
        "subnets": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "summary": {
          "type": "object",
          "properties": {
            "total_ips": {
              "type": "integer"
            },
            "ipv4_count": {
              "type": "integer"
            },
            "ipv6_count": {
              "type": "integer"
            },
            "allocated_count": {
              "type": "integer"
            },
            "available_count": {
              "type": "integer"
            },
            "subnet_count": {
              "type": "integer"
            }
          }
        }
      }
    }
  }
}