> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargeapi.co/llms.txt
> Use this file to discover all available pages before exploring further.

# List Policies

Returns a paginated list of policy objects for the authenticated account.

<RequestExample>
  ```bash cURL theme={null}
  curl -G https://api.chargeapi.co/v1/policies \
    -H "Authorization: Bearer ch_sk_test_..." \
    -d status=active \
    -d limit=10
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
      "data": [
          {
              "id": "pol_hbyAN9SMUkmo8AD0bk10VD27dOK0gqah",
              "object": "policy",
              "created": "2026-04-01T00:17:55.220Z",
              "description": null,
              "metadata": {},
              "mode": "enforcement",
              "name": "Example Policy",
              "rules": {
                  "allowed_operators": ["example_operator"],
                  "denied_operators": [],
                  "geofences": [
                      {
                          "center": {
                              "latitude": 48.8698,
                              "longitude": 2.3319
                          },
                          "name": "Example Zone",
                          "radius_meters": 1500
                      }
                  ],
                  "max_price_per_kwh": 25,
                  "time_windows": [
                      {
                          "days_of_week": ["monday", "tuesday", "wednesday", "thursday", "friday"],
                          "end_time": "18:00",
                          "start_time": "09:00"
                      }
                  ]
              },
              "status": "active"
          }
      ],
      "next_page_url": "https://api.chargeapi.co/v1/policies?page=page_MHyulbAysB6BGMUs3AFd85UXM2nM5x1F86hzmpqo3uQ&status=active&limit=10",
      "previous_page_url": null
  }
  ```
</ResponseExample>

## Parameters

<ParamField query="limit" type="integer">
  Maximum number of objects to return (default 10).
</ParamField>

<ParamField query="page" type="string">
  Page token from a previous list response.
</ParamField>

<ParamField query="status" type="string">
  Filter policies by status.

  Available options: `active`, `inactive`
</ParamField>

## Returns

Returns a page of policies.

<ResponseField name="data" type="array of object" required>
  Array of policy objects.
</ResponseField>

<ResponseField name="next_page_url" type="string | null" required>
  URL for the next page of results, or `null` when there is no next page.
</ResponseField>

<ResponseField name="previous_page_url" type="string | null" required>
  URL for the previous page of results, or `null` when there is no previous page.
</ResponseField>