v1

latestOpenAPI 3.1.02026-07-2616459400.5 KB

IP Management API

Get IP Request Status

This allows a parent account to retrieve the current status and details of a specific dedicated IP request. By providing the unique request_id, you can track whether the request is pending, approved, partially approved, or rejected, along with related information such as the number of IPs requested, allocated, and any remarks.

get/ip/request/{request_id}

Path parameters

request_idstring required

The unique identifier of the dedicated IP request to retrieve. This ID is returned when a new IP request is submitted. Must be a valid request ID format. If the ID does not exist or is invalid, the API returns an error.

Response

IP request status retrieved successfully

request_idstring

status'pending' | 'approved' | 'rejected' | 'processing'

requested_ipsinteger

allocated_ipsinteger

regionstring

descriptionstring

remarksstring

Example response

{
  "request_id": "IP-REQ-2024-001-ABC123",
  "status": "approved",
  "requested_ips": 5,
  "allocated_ips": 5,
  "region": "US",
  "description": "Additional IPs for marketing campaigns",
  "remarks": "Request approved and IPs allocated successfully"
}