Skip to main content
POST
/
api
/
v1
/
ips
/
reserve
Reserve a floating IP
curl --request POST \
  --url https://api.rafftechnologies.com/api/v1/ips/reserve \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-Project-ID: <x-project-id>' \
  --data '
{
  "type": "IPv4",
  "region": "us-east",
  "billing_period": "monthly"
}
'
{
  "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"
  }
}
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).

Body

application/json

Optional fields for IP reservation. Send an empty body to use defaults.

​
type
enum<string>
default:IPv4

IP family to reserve. Defaults to IPv4.

Available options:
IPv4,
IPv6
​
region
enum<string>

Region. Defaults to the project's default region.

Available options:
us-east
​
billing_period
enum<string>
default:monthly

Subscription billing period. Ignored for PAYG accounts.

Available options:
monthly,
yearly,
twenty_four_month

Response

IP reserved

​
success
boolean
​
data
object

A floating public IP address.

Last modified on May 8, 2026