List gateway policies

Returns every gateway policy in the current organization. The response includes both admin-created policies and runtime-materialized children of default_spend_cap policies (children carry parent_policy_id).

Spend tracking: each spend-cap policy carries current_spend_usd — the spend accumulated in the policy’s active window.

GET /v1/platform/gateway-policies

Error

A valid request URL is required to generate request examples

200

[
  {
    "action": "<string>",
    "config": {},
    "created_at": "<string>",
    "created_by": "<string>",
    "current_spend_usd": 123,
    "description": "<string>",
    "enabled": true,
    "id": "<string>",
    "is_system_generated": true,
    "name": "<string>",
    "organization_id": "<string>",
    "parent_policy_id": "<string>",
    "policy_type": "<string>",
    "priority": 123,
    "subject_matchers": [
      {
        "key": "<string>",
        "value": "<string>"
      }
    ],
    "updated_at": "<string>"
  }
]

Authorizations

API KeyBearer Auth

X-API-Key · string · header · required

Response

200

application/json

OK

action · string

config · object

created_at · string

created_by · string

current_spend_usd · number

CurrentSpendUSD is the spend in the policy's current window. Set for any spend_cap policy regardless of enabled state — disabled policies still surface usage so users can see what would have been counted. Nil for non-spend_cap policies or when the spend lookup failed.

description · string

enabled · boolean

id · string

is_system_generated · boolean

name · string

organization_id · string

parent_policy_id · string

ParentPolicyID is set on materialized children of a default_spend_cap to the default's id, and cleared (NULL) only when an admin Create with the same matchers takes over the materialized row. Update on a child preserves the link; Delete on the parent cascade-soft-deletes every child rather than detaching them.

policy_type · string

priority · integer

subject_matchers · object[]

Show child attributes

updated_at · string