Skip to main content
GET
/
api
/
v1
/
ips
List floating IPs
curl --request GET \
  --url https://api.rafftechnologies.com/api/v1/ips \
  --header 'X-API-Key: <api-key>' \
  --header 'X-Project-ID: <x-project-id>'
{
  "success": true,
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "ip_address": "203.0.113.42",
      "reserved": true,
      "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "region": "us-east",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "total": 123
}
Updated May 8, 2026

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Each key is bound to a specific account.

Headers

​
X-Project-ID
string<uuid>
required

Project ID. Required for all mutating operations (create, delete, power actions, resize).

Query Parameters

​
reserved
boolean

When true, return only reserved IPs (not currently attached to a VM).

​
status
enum<string>

Filter by IP status:

  • free — IP is in the pool. Combined with reserved=true it means held for the account but not attached to a VM.
  • in-use — currently attached to a VM.
Available options:
free,
in-use
​
limit
integer
default:20
​
offset
integer
default:0

Response

List of floating IPs

​
success
boolean
​
data
object[]
​
total
integer
Last modified on May 8, 2026