---
title: "List Discoveries Across All Configurations"
method: GET
path: "/v1/cookie-consent/discoveries"
tags: ["cmp"]
---

# List Discoveries Across All Configurations

`GET /v1/cookie-consent/discoveries`

## Request

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

Returns uncategorized Discoveries from all of the authenticated customer's Cookie Consent Configurations, without requiring a configuration ID. Each discovery includes the `configId` and `configName` 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'
- `classification` 'ESSENTIAL' | 'ANALYTICS' | 'MARKETING' | 'PERSONALIZATION' | 'HIDDEN' | 'BLACKLISTED'
- `limit` integer
- `next` string

## Response `200`

Success

- CmpCustomerDiscoveriesResponseList
  - `items` CmpCustomerDiscovery[], required
    - `customerId` string
    - `configId` string, uuid
    - `configName` string: The name of the Cookie Consent Configuration the discovery belongs to.
    - `storeKey` string: The discovered item, e.g. the cookie name or script URL.
    - `type` 'cookie' | 'script' | 'iframe' | 'localStorage'
    - `created` string, date-time: The date and time the discovery was created (displayed as "First Date Seen" in my.osano.com).
    - `updated` string, date-time
    - `firstPageSeen` string, URL, nullable
    - `scanOrigin` 'URL Scan' | 'osano.js', nullable: "URL Scan" if it was discovered by a URL scan, "osano.js" if not, and null if the origin is not available.
    - `pattern` string, nullable: The suggested rule pattern from Osano's curated dataset, as a regular expression. Null when there is no suggestion.
    - `classification` 'ANALYTICS' | 'BLACKLISTED' | 'ESSENTIAL' | 'HIDDEN' | 'MARKETING' | 'PERSONALIZATION', nullable: The suggested classification from Osano's curated dataset. Null when there is no suggestion.
    - `vendorId` string, nullable
    - `vendorName` string, nullable
    - `expiry` string, nullable: Only set for cookie discoveries.
    - `description` string, nullable
    - `research` string, nullable
    - `confidence` string, nullable: The AI confidence level (`low`, `medium`, `high`) for the suggested classification. Only available for cookie discoveries; "Unknown" for other types.
  - `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/discoveries/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)