---
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`

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 — The flag to determine if the list is empty.
    - `sorted` boolean — The flag to determine if the list is sorted. If set True, the list is sorted.
    - `unsorted` boolean — The flag to determine if the list is unsorted. If set True, the list is 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.net/onetrust/apis/platform-access-management.md) · [All operations](https://skmtc.net/onetrust/apis/platform-access-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onetrust/platform-access-management/versions/21de3aa0b170/schema)