Skip to main content
GET
/
vpc
/
prefix-lists
/
{prefixListId}
Retrieve a prefix list
curl --request GET \
  --url https://v1.api.altostrat.io/vpc/prefix-lists/{prefixListId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw",
  "name": "Main Office IPs",
  "description": "Public IP ranges for the main office.",
  "status": "active",
  "sites": [
    "site_12345"
  ],
  "prefixes": [
    {
      "id": "prfx_0ujsswThIGTUYm2K8FjOOfxcYpw",
      "cidr": "192.0.2.0/24",
      "description": "Main server subnet"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://altostrat.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Authentication is performed via an Auth0-issued JSON Web Token (JWT). Provide the token in the Authorization header with the Bearer scheme.

Path Parameters

​
prefixListId
string
required

The unique identifier for the prefix list, prefixed with prfx_lst_.

Pattern: ^prfx_lst_[0-9a-zA-Z]{27}$
Example:

"prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw"

Response

The requested prefix list object.

Represents a reusable, named collection of IP addresses and CIDR blocks.

​
id
string
read-only

The unique identifier for the prefix list, prefixed with prfx_lst_.

Example:

"prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw"

​
name
string

A human-readable name for the prefix list.

Example:

"Main Office IPs"

​
description
string

An optional description for the prefix list.

Example:

"Public IP ranges for the main office."

​
status
enum<string>
read-only

The current synchronization status of the prefix list.

Available options:
active,
syncing,
failed
Example:

"active"

​
sites
string[]

A list of site IDs where this prefix list is directly applied.

​
prefixes
object[]

The list of CIDR blocks in this prefix list.