---
title: "Get extant"
method: GET
path: "/v1/policies"
tags: ["Policies"]
---

# Get extant

`GET /v1/policies`

Gets user associated policies basic information.

## Query parameters

- `include_global_policies` boolean
- `organization_id` integer
- `page` object
  - `number` integer
  - `size` integer

## Response `200`

Policies basic information

- object
  - `data` PolicySpec[]
    - `id` string — Resource Id (integer or uuid)
    - `type` string — Resource type name
    - `uuid` string — Resource UUID (if applicable)
    - `attributes` Policy — Policy resource
      - `name` string — Policy name
      - `organization_id` integer — Organization ID
      - `whitelist_domains` string[] — Allowlisted domains
      - `blacklist_domains` string[] — Blocklisted domains
      - `blacklist_categories` integer[] — Blocklisted categories
      - `allow_unknown_domains` boolean — Allow unknown domains yes/no
      - `google_safesearch` boolean — Force Google safe search yes/no
      - `bing_safe_search` boolean — Force Bing safe search yes/no
      - `duck_duck_go_safe_search` boolean — Force Duck Duck Go safe search yes/no
      - `ecosia_safesearch` boolean — Force Ecosia safe search yes/no
      - `yandex_safe_search` boolean — Force Yandex safe search yes/no
      - `youtube_restricted` boolean — YouTube blocked yes/no
      - `youtube_restricted_level` 'strict' | 'none' — YouTube restricted level
      - `interstitial` boolean — Interstitial page enabled yes/no
      - `is_global_policy` boolean — Policy is a global policy yes/no
      - `can_edit` boolean — Current user can edit the policy yes/no
      - `lock_version` integer — Object version
      - `allow_list_only` boolean — If true, only domains on the allow list will be allowed. All others will be blocked regardless of configuration.
    - `relationships` object — Policy associated resources
      - `organization` object
        - `data` IdType — JSON API resource ID and type attributes
          - `id` string — Resource Id (integer or uuid)
          - `type` string — Resource type name
          - `uuid` string — Resource UUID (if applicable)
      - `network_policies` object
        - `data` IdType[]
          - `id` string — Resource Id (integer or uuid)
          - `type` string — Resource type name
          - `uuid` string — Resource UUID (if applicable)
      - `networks` object
        - `data` IdType[]
          - `id` string — Resource Id (integer or uuid)
          - `type` string — Resource type name
          - `uuid` string — Resource UUID (if applicable)
  - `links` Links — JSON API links member representation
    - `self` string — Endpoint URL (may be null)

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/dnsfilter/apis/dnsfilter-api.md) · [All operations](https://skmtc.net/dnsfilter/apis/dnsfilter-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dnsfilter/dnsfilter-api/revisions/29e5e6ee3316/schema)