# List

`GET /api/2.0/policy-families`

Returns the list of policy definition types available to use at their latest version. This API is paginated.

API scopes: clusters

## Query parameters

- `max_results` (int64, optional)
  Maximum number of policy families to return.
  Constraints: `[ 1 .. 1000 ]`
- `page_token` (string, optional)
  A token that can be used to get the next page of results.

## Returns

Returns a list of PolicyFamily objects.

## Response

```json
{
  "policy_families": [
    {
      "policy_family_id": "string",
      "name": "string",
      "description": "string",
      "definition": {
        "custom_tags.test_tag": {
          "type": "fixed",
          "value": "test_value"
        }
      }
    }
  ],
  "next_page_token": "string"
}
```