List limit policies

GET

https://api.respan.ai/api/limit-policies/

GET

/api/limit-policies/

$ curl https://api.respan.ai/api/limit-policies/ \
>      -H "Authorization: Bearer <respanApiKey>"

200Retrieved

1 {
2   "results": [
3     {
4       "id": "string",
5       "name": "string",
6       "scope": "string",
7       "scope_value": "string",
8       "compose": [
9         "string"
10       ],
11       "metric": "cost",
12       "algorithm": "balance_fixed_window",
13       "period": "string",
14       "anchor": "calendar",
15       "anchor_at": "2024-01-15T09:30:00Z",
16       "effective_at": "2024-01-15T09:30:00Z",
17       "expires_at": "2024-01-15T09:30:00Z",
18       "priority": 0,
19       "is_active": true,
20       "rules": [
21         {
22           "trigger": {},
23           "severity": "soft",
24           "description": "string",
25           "is_active": true,
26           "notification_method_id": "string"
27         }
28       ],
29       "threshold_value": 1.1,
30       "meter_definition_id": "string",
31       "current_state": {
32         "meter_id": "string",
33         "interval_start": 1,
34         "interval_end": 1,
35         "current_value": 1.1
36       },
37       "created_at": "2024-01-15T09:30:00Z",
38       "updated_at": "2024-01-15T09:30:00Z"
39     }
40   ],
41   "count": 1,
42   "next": "string",
43   "previous": "string"
44 }

List every configured policy in your organization, including zero-traffic policies. Each carries its live current_state.

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

orderingstringOptionalDefaults to -updated_at

Prefix with - for descending.

Response

Paginated list of policies.

resultslist of objectsOptional

countintegerOptional

nextstring or nullOptional

previousstring or nullOptional