Get a gateway policy

Returns a single gateway policy by id. Cross-org access is rejected with 404

Spend tracking: spend-cap policies include current_spend_usd for the active window so callers can read per-policy cost without hitting a separate endpoint. Guard policies leave it null.

GET /v1/platform/gateway-policies/{id}

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

Path Parameters

id · string<uuid> · required

Policy ID

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