List limit policies | Respan Docs

{
  "results": [
    {
      "id": "string",
      "name": "string",
      "scope": "string",
      "scope_value": "string",
      "compose": [
        "string"
      ],
      "metric": "cost",
      "algorithm": "balance_fixed_window",
      "period": "string",
      "anchor": "calendar",
      "anchor_at": "2024-01-15T09:30:00Z",
      "effective_at": "2024-01-15T09:30:00Z",
      "expires_at": "2024-01-15T09:30:00Z",
      "priority": 0,
      "is_active": true,
      "rules": [
        {
          "trigger": {},
          "severity": "soft",
          "description": "string",
          "is_active": true,
          "notification_method_id": "string"
        }
      ],
      "threshold_value": 1.1,
      "meter_definition_id": "string",
      "current_state": {
        "meter_id": "string",
        "interval_start": 1,
        "interval_end": 1,
        "current_value": 1.1
      },
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-01-15T09:30:00Z"
    }
  ],
  "count": 1,
  "next": "string",
  "previous": "string"
}

List policies in your organization with their live current_state, including policies with no traffic.

Authentication

AuthorizationBearer

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

Query parameters

pageintegerOptionalDefaults to 1

page_sizeintegerOptionalDefaults to 50

sort_bystringOptionalDefaults to -updated_at

Field to sort by. Prefix with - for descending.

Response

Paginated list of policies.

resultslist of objectsOptional

countintegerOptional

Number of results on this page, not the total. Request pages until next is null to get every result.

nextstring or nullOptional

previousstring or nullOptional

Errors

403

Forbidden Error