List Floating IPs
GET
/floating-ipsList of all active Floating IP addresses.
Request
Query Params
page
integerÂ
optional
Which page of paginated results to return.
per_page
integerÂ
optional
How many results per page to be shown.
filter[ip]
stringÂ
optional
Filter servers by IP address.
filter[search]
stringÂ
optional
Combined search field. Searches by IP and by server's hostname (if attached).
filter[status]
stringÂ
optional
Filter servers by Status. Default filter is: active,suspended
filter[ddos]
booleanÂ
optional
Filter wether the IP is DDoS protected or not.
Request samples
Responses
List of all Floating IPs.(200)
List of all Floating IPs.
HTTP Code:Â 200
Content Type :Â JSONapplication/json
Data Schema
data
array [object]Â
required
links
objectÂ
required
first
stringÂ
required
last
stringÂ
required
prev
nullÂ
required
next
nullÂ
required
meta
objectÂ
required
current_page
integerÂ
required
from
integerÂ
required
last_page
integerÂ
required
links
array [object {3}]Â
required
path
stringÂ
required
per_page
integerÂ
required
to
integerÂ
required
total
integerÂ
required
Example
{
"data": [
{
"id": 602,
"status": "active",
"server_id": null,
"server_hostname": null,
"server_main_ip": null,
"locked": false,
"locked_at": null,
"lock_reason": null,
"billing_cycle": 1,
"expiry_at": "2024-10-15T21:00:00.000000Z",
"plan": {
"id": 32,
"name": "floating-ipv4",
"available": true,
"price": 2.5,
"price_with_vat": 3
},
"ip_address": {
"id": 47,
"ip_address": "87.120.37.46",
"prefix": 32,
"version": 4,
"type": "public",
"main": false,
"ddos_protected": false,
"ptr": {
"87.120.37.46": "example.com"
}
},
"cancel_request": {
"id": 233,
"type": 1,
"reason": "Example reason.",
"created_at": "2024-09-25T14:16:15.000000Z"
}
},
{
"id": 608,
"status": "active",
"server_id": null,
"server_hostname": null,
"server_main_ip": null,
"locked": false,
"locked_at": null,
"lock_reason": null,
"billing_cycle": 1,
"expiry_at": "2024-10-25T12:25:04.000000Z",
"plan": {
"id": 32,
"name": "floating-ipv4",
"available": true,
"price": 2.5,
"price_with_vat": 3
},
"ip_address": {
"id": 416,
"ip_address": "87.121.52.159",
"prefix": 32,
"version": 4,
"type": "public",
"main": false,
"ddos_protected": false,
"ptr": null
},
"cancel_request": {
"id": 234,
"type": 1,
"reason": "Example reason.",
"created_at": "2024-09-25T14:16:16.000000Z"
}
}
],
"links": {
"first": "https://api.vpsbg.eu/v1/floating-ips?page=1",
"last": "https://api.vpsbg.eu/v1/floating-ips?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "https://api.vpsbg.eu/v1/floating-ips?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"path": "https://api.vpsbg.eu/v1/floating-ips",
"per_page": 50,
"to": 1,
"total": 1
}
}
Last modified: 12 days ago