---
title: "Get List of Cookies by Criteria"
method: POST
path: "/v2/cookie-reports/search"
tags: ["Cookies"]
---

# Get List of Cookies by Criteria

`POST /v2/cookie-reports/search`

## Request

- Base URL: `https://customer.my.onetrust.com/api/cookiemanager`
- URL: `https://customer.my.onetrust.com/api/cookiemanager/v2/cookie-reports/search`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://{$$.env.host}/api/access/v1/oauth/token`

Use this API to retrieve a list of all cookies by filter criteria.
> 🗒 Things to Know
> 
> - If any of the available languages in the OneTrust application is entered as a value for the `language` parameter, cookie categories, descriptions, and third-party descriptions will be translated accordingly. 
> - It is recommended to use the `page` and `size` parameters if the number of cookies is greater than 500.

## Query parameters

- `language` string
- `countryCode` string
- `searchStr` string
- `page` integer
- `size` integer

## Request body

- object
  - `domains` string[]

## Response `200`

OK

Cookie details retrieved successfully.

- PaginatedCookieResponseDTO: Paginated List of cookies with domain level info
  - `content` CookieDetailsDto[]: List of cookies with domain level information
    - `cookieName` string: Name of a cookie.
    - `lifespan` string: Lifespan of a cookie.
    - `host` string: Host associated with a cookie.
    - `defaultCategory` string: Default category of a cookie.
    - `cookieSource` string: Source of a cookie (SCAN or MANUAL).
    - `defaultDescription` string: Description of a cookie.
    - `defaultThirdPartyDescription` string: Third party description of a cookie.
    - `expiry` string: Expiry duration of a cookie(For example, 4 weeks or 2 days or 5 months or 3 years).
    - `thirdParty` boolean: Indicates the type of a cookie. If set to true, then third party cookie else first party cookie.
    - `domainCookieInfo` DomainCookieInfo[]
      - `cookieId` string: Id of a cookie.
      - `domainCookieId` string: Id of domaincookie.
      - `domainName` string: Name of the domain.
      - `displayGroupName` string: Category name of cookie for that domain.
      - `cookieCategoryID` string: Category ID of the cookie.
      - `thirdParty` boolean: Indiactes the type of the cookie. If set to true, then third party cookie else first party cookie for that domain.
      - `description` string: Description of a cookie.
  - `numberOfElements` integer: Total number of elements in the result list.
  - `pageNumber` integer: Page number of the results list (0….N).
  - `pageSize` integer: Number of records per page (0…N).
  - `sort` Sort
    - `empty` boolean: Flag to indicate if the results are empty or not.
    - `sorted` boolean: Flag to indicate if the results are sorted or not. If set to TRUE, the results are sorted.
    - `unsorted` boolean: Flag to indicate if the results are unsorted or not. If set to TRUE, the results are unsorted.
  - `totalElements` integer: Total number of cookie results found.
  - `totalPages` integer: Total number of pages in the result.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).

---

[API](https://skmtc.dev/onetrust/apis/consent-preferences-cookie-consent-swagger.md) - [All operations](https://skmtc.dev/onetrust/apis/consent-preferences-cookie-consent-swagger/llms.txt) - [OpenAPI document](https://skmtc.dev/onetrust/apis/consent-preferences-cookie-consent-swagger/revisions/91142c74595f?raw)