---
title: "List Rules Across All Configurations"
method: GET
path: "/v1/cookie-consent/rules"
tags: ["cmpRules"]
---

# List Rules Across All Configurations

`GET /v1/cookie-consent/rules`

## Request

- Base URL: `https://api.osano.com`
- URL: `https://api.osano.com/v1/cookie-consent/rules`
- Auth: API key in header `x-osano-api-key`
- TypeScript: <https://skmtc.dev/osano/apis/osano-api-reference/docs/v1/cookie-consent/rules/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns Cookie Consent Rules from all of the authenticated customer's Cookie Consent Configurations, without requiring a configuration ID, most recently created first. Each rule includes the `configId` it belongs to. Filters can be combined. Results are paginated with up to 500 items per page; pass the `next` token from the response to get the following page, until a page comes back empty (the token carries the original filters, so other query parameters are ignored when `next` is set).

## Query parameters

- `configId` string, uuid
- `rule` string
- `type` 'cookie' | 'script' | 'iframe' | 'localStorage'
- `ruleType` 'FILENAME' | 'DOMAIN' | 'PATH' | 'REGEXP' | 'STARTS_WITH' | 'ENDS_WITH' | 'CONTAINS' | 'EXACT_MATCH'
- `classification` 'ESSENTIAL' | 'ANALYTICS' | 'MARKETING' | 'PERSONALIZATION' | 'HIDDEN' | 'BLACKLISTED'
- `limit` integer
- `next` string

## Response `200`

Success

- CmpCustomerRulesResponseList
  - `items` CmpCustomerRule[], required
    - `ruleId` integer
    - `configId` string, uuid
    - `type` 'cookie' | 'script' | 'iframe' | 'localStorage'
    - `classification` 'ANALYTICS' | 'BLACKLISTED' | 'ESSENTIAL' | 'HIDDEN' | 'MARKETING' | 'PERSONALIZATION'
    - `rule` string
    - `ruleType` 'FILENAME' | 'DOMAIN' | 'PATH' | 'REGEXP' | 'STARTS_WITH' | 'ENDS_WITH' | 'CONTAINS' | 'EXACT_MATCH', nullable
    - `title` string, nullable
    - `vendorId` string, nullable
    - `vendorName` string, nullable
    - `disclosure` boolean
    - `expiry` string, nullable: Only set for cookie rules.
    - `description` string, nullable
    - `created` string, date-time
    - `updated` string, date-time
  - `next` string: Pagination token for the next page. Omitted when the page is empty.

## Other responses

- `400`: Bad Request
- `404`: Not Found. Returned when `configId` does not identify one of the customer's configurations.

## Changes

- **2026-11-06** `ac31099cf83e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/osano/apis/osano-api-reference/changes/v1/cookie-consent/rules/get.md)

---

[API](https://skmtc.dev/osano/apis/osano-api-reference.md) - [All operations](https://skmtc.dev/osano/apis/osano-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/osano/apis/osano-api-reference/revisions/ac31099cf83e?raw)