Skip to main content
GET
/
prefix-lists
List prefix lists
curl --request GET \
  --url https://api.altostrat.io/prefix-lists \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw",
    "name": "Main Office IPs",
    "description": "Public IP ranges for the main office.",
    "status": "active",
    "sites": [],
    "prefixes": []
  },
  {
    "id": "prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpz",
    "name": "Third-Party APIs",
    "description": "IPs for critical third-party services.",
    "status": "active",
    "sites": [],
    "prefixes": []
  }
]

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.

Response

A list of prefix lists.

โ€‹
id
string

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>

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.