Skip to content
StratumStratum Docs

List a listener's rules.

GET
/v1/projects/{projectId}/lb/listeners/{listenerId}/rules
Code sample: Shell / cURL
curl --request GET \
  --url 'https://stratum.example.com/v1/projects/example/lb/listeners/example/rules?limit=100' \
  --header 'Authorization: Bearer <token>'

Cursor-paginated. Ordered priority, id.

Rule priorities are not unique, so id is the tiebreaker that makes the order total; without it a cursor sitting on two rules of equal priority repeats or skips one.

This endpoint returned every rule with no limit of any kind until .

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
projectId
required
string
/^p-[a-z0-9-]+$/
listenerId
required
string
/^lis-[a-z0-9]+$/

Query Parameters

Section titled “Query Parameters”
limit
integer
default: 100 >= 1 <= 500
page_token
string

Opaque cursor from a previous response’s nextPageToken. Omit for the first page.

Responses

Section titled “Responses”

200

Section titled “200”

Rules.

Media typeapplication/json
object
items
required
Array<object>
object
id
required
string
/^lbr-[a-z0-9]+$/
listenerId
required
string
priority
required
integer
>= 1 <= 50000
conditions
required

Match conditions; 2.0 reads hosts + pathPrefix, Slice F adds method/header/source-ip/query.

object
key
additional properties
any
actions
required
object
key
additional properties
any
createdAt
string format: date-time
updatedAt
string format: date-time
nextPageToken
string

Example generated

{
  "items": [
    {
      "id": "example",
      "listenerId": "example",
      "priority": 1,
      "conditions": {},
      "actions": {},
      "createdAt": "2026-04-15T12:00:00Z",
      "updatedAt": "2026-04-15T12:00:00Z"
    }
  ],
  "nextPageToken": "example"
}