v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB
DigitalOcean-public.v2-new_BYOIP Prefixes

List BYOIP Prefixes

To list all BYOIP prefixes, send a GET request to /v2/byoip_prefixes. A successful response will return a list of all BYOIP prefixes associated with the account.

get/v2/byoip_prefixes

Query parameters

per_pageinteger

Number of items returned per page

pageinteger

Which 'page' of paginated results to return.

Response

List of BYOIP prefixes as an array of BYOIP prefix JSON objects

Example response

{
  "byoip_prefixes": [
    {
      "uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "prefix": "203.0.113.0/24",
      "status": "active",
      "region": "nyc3",
      "validations": [
        {
          "name": "SIGNATURE HASH",
          "status": "FAILED"
        }
      ],
      "advertised": true,
      "project_id": "12345678-1234-1234-1234-123456789012"
    }
  ],
  "links": {
    "pages": {
      "last": "https://api.digitalocean.com/v2/images?page=2",
      "next": "https://api.digitalocean.com/v2/images?page=2"
    }
  },
  "meta": {
    "total": 1
  }
}