---
title: "Get List of Privacy Notice Versions"
method: GET
path: "/v2/privacynotices/{privacyNoticeId}/versions"
tags: ["Privacy Notice V2"]
---

# Get List of Privacy Notice Versions

`GET /v2/privacynotices/{privacyNoticeId}/versions`

## Request

- Base URL: `https://hostname/api/privacynotice`
- URL: `https://hostname/api/privacynotice/v2/privacynotices/{privacyNoticeId}/versions`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://{hostname}/api/access/v1/oauth/token` scopes: `GENERIC`, `POLICY`

Use this API to retrieve a list of versions for a specific privacy notice.

## Path parameters

- `privacyNoticeId` string, uuid, required: ID of the privacy notice. The value can be obtained using [Get List of Privacy Notices](/onetrust/reference/getprivacynoticesusingget) API.

## Query parameters

- `page` integer: Results page to be retrieved (0..N). Example- '?page=1
- `size` integer: Number of records per page (1..50). Example- '?size=30

## Response `200`

OK

- PrivacyNoticeVersionDetailsDtoV2[]
  - `id` string, uuid: Unique Identifier identifying a Notice Version
  - `name` string: Name of the Notice Version
  - `status` 'ACTIVE' | 'DRAFT' | 'RETIRED' | 'INACTIVE'
  - `version` integer: Version number of the Notice Version
  - `publishedDate` string, date-time: Published Date of Notice Version
  - `publishedBy` string, uuid: Publisher of the Notice Version
  - `languages` PrivacyNoticeLanguageDetailsDtoV2[]: Languages Supported by Notice Version
    - `guid` string, uuid: Unique Identifier identifying a Notice Version Language
    - `languageCode` string: Language Code of the Notice Version
    - `defaultLanguage` boolean: Default Language of the Notice Version

## 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-policy-notice-management.md) - [All operations](https://skmtc.dev/onetrust/apis/consent-preferences-policy-notice-management/llms.txt) - [OpenAPI document](https://skmtc.dev/onetrust/apis/consent-preferences-policy-notice-management/revisions/16c7be9e492f?raw)