---
title: "Get Categorized Cookies"
method: POST
path: "/api/cmp/v1/cookies/categorized"
tags: ["Cookies"]
---

# Get Categorized Cookies

`POST /api/cmp/v1/cookies/categorized`

## Request

- Base URL: `https://hostname`
- URL: `https://hostname/api/cmp/v1/cookies/categorized`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://{hostname}/api/access/v1/oauth/token` scopes: `COOKIE`, `COOKIE_READ`

Use this API to retrieve categorized cookies by domain.

## Request body

- CategorizedCookiesRequestDto
  - `domain` string: The website domain being managed.
  - `cookieIds` string[]: The list of cookie identifiers.
  - `cookies` CookieRequestDto[]: The list of cookie objects containing detailed information about each cookie.
    - `name` string: The name of the cookie.
    - `host` string: The domain or website that created the cookie.

## Response `200`

OK

- CookiepediaContribsDto[]
  - `name` string: The name of the item.
  - `type` string: The type or category classification of the item.
  - `host` string: The domain or website that created the cookie.
  - `hostDescription` string: The description of the host domain.
  - `description` string: The description of the item and its intended purpose.
  - `firstPartyDescription` string: The description of first-party cookies and their usage.
  - `thirdPartyDescription` string: The description of third-party cookies and their usage.
  - `patternKey` string: The pattern key used for cookie identification and matching.
  - `thirdPartyKey` string: The key identifier used for third-party cookie classification.
  - `firstPartyKey` string: The key identifier used for first-party cookie classification.
  - `category` string: The category assigned to the cookie for classification purposes.
  - `domainCount` integer: No of domains where this cookie is active.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).
- `500`: Internal Server Error

---

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