> ## Documentation Index
> Fetch the complete documentation index at: https://developer.onetrust.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Privacy Notice Version

Use this API to retrieve a specific version of the privacy notice by the published date and time. The response will return details on the version of the privacy notice that was most recently published before the value specified in the `date` parameter.


# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Consent & Preferences - Policy & Notice Management",
    "version": "1.0",
    "contact": {
      "name": "OneTrust Support",
      "url": "https://my.onetrust.com/s/contactsupport"
    },
    "license": {
      "name": "Apache 2.0",
      "url": "https://www.apache.org/licenses/LICENSE-2.0"
    },
    "description": "The Policy & Notice Management APIs are used to list privacy notices, page through results, view version history for a notice, and retrieve the version that was effective at a specific date and time."
  },
  "servers": [
    {
      "url": "https://{hostname}/api/privacynotice",
      "variables": {
        "hostname": {
          "default": "hostname",
          "description": "The OneTrust hostname such as app.onetrust.com, app-eu.onetrust.com, app-de.onetrust.com, app-uk.onetrust.com, app-apac.onetrust.com, trial.onetrust.com, or uat.onetrust.com."
        }
      }
    }
  ],
  "tags": [
    {
      "name": "Privacy Notice V2",
      "description": "APIs used to list privacy notices, fetch versions for a notice, and get the notice version active on a given date/time.",
      "externalDocs": {
        "description": "OpenAPI 3.1.0 - Download Definition",
        "url": "https://developer.onetrust.com/onetrust/openapi/consent-preferences-policy-notice-management.json"
      }
    }
  ],
  "x-onetrust": {
    "spec-label": "OpenAPI 3.1.0",
    "links": [
      "{'Policy & Notice Management Knowledge Base': 'https://my.onetrust.com/s/topic/0TO3q000000kIWPGA2/policy-notice-management'}"
    ]
  },
  "x-readme": {
    "explorer-enabled": false,
    "proxy-enabled": false,
    "metrics-enabled": false
  },
  "paths": {
    "/v2/privacynotices/{id}": {
      "get": {
        "operationId": "getPrivacyNoticeVersionByPublishedDateUsingGET",
        "summary": "Get Privacy Notice Version",
        "description": "Use this API to retrieve a specific version of the privacy notice by the published date and time. The response will return details on the version of the privacy notice that was most recently published before the value specified in the `date` parameter.\n",
        "tags": [
          "Privacy Notice V2"
        ],
        "x-onetrust": {
          "spec-label": "https://developer.onetrust.com/onetrust/openapi/consent-preferences-policy-notice-management.json"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "description": "UUID of the Privacy Notice. The value can be obtained using [Get List of Privacy Notices](/onetrust/reference/getprivacynoticesusingget) API.",
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "date",
            "in": "query",
            "required": true,
            "schema": {
              "description": "Date and time to fetch the version. Accepted formats: yyyy-MM-dd or yyyy-MM-ddTHH:mm:ss.",
              "type": "string",
              "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}(T[0-9]{2}:[0-9]{2}:[0-9]{2})?$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PrivacyNoticeWithVersionDtoV2"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "429": {
            "description": "Too Many Requests \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).",
            "headers": {
              "ot-ratelimit-event-id": {
                "style": "simple",
                "schema": {
                  "description": "The unique identifier for the rate-limiting event.",
                  "format": "uuid"
                }
              },
              "Retry-After": {
                "style": "simple",
                "schema": {
                  "description": "The number of seconds after which requests will be allowed again.",
                  "format": "int32"
                }
              },
              "ot-requests-allowed": {
                "style": "simple",
                "schema": {
                  "description": "The number of requests allowed within the specified period.",
                  "format": "int32"
                }
              },
              "ot-period": {
                "style": "simple",
                "schema": {
                  "description": "The unit of time for which the rate limit applies.",
                  "enum": [
                    "HOUR",
                    "MINUTE"
                  ]
                }
              },
              "ot-request-made": {
                "style": "simple",
                "schema": {
                  "description": "The number of requests made within the specified period.",
                  "format": "int32"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PrivacyNoticeWithVersionDtoV2"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "OAUTH2": [
              "GENERIC",
              "POLICY"
            ]
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "PrivacyNoticeVersionDtoV2": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Unique Identifier identifying a Privacy Notice Version",
            "type": "string",
            "format": "uuid",
            "example": "625ba071-61b0-485f-81a0-a2245777b400"
          },
          "name": {
            "description": "Name of the Privacy Notice",
            "type": "string",
            "example": "California Privacy Policy",
            "maxLength": 200,
            "minLength": 1
          },
          "publishedDate": {
            "description": "The date Privacy Notice version was published on",
            "type": "string",
            "format": "date-time",
            "example": "2020-05-14T00:00:48.62"
          },
          "status": {
            "description": "The Status of Privacy Notice Version",
            "type": "string",
            "example": "ACTIVE",
            "enum": [
              "ACTIVE",
              "DRAFT",
              "RETIRED",
              "INACTIVE"
            ]
          },
          "version": {
            "description": "The Version of Privacy Notice",
            "type": "integer",
            "format": "int64",
            "example": 3
          }
        }
      },
      "PrivacyNoticeWithVersionDtoV2": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Unique Identifier identifying a Privacy Notice",
            "type": "string",
            "format": "uuid",
            "example": "625ba071-61b0-485f-81a0-a2245777b431"
          },
          "createdDate": {
            "description": "The Date Privacy Notice was created on",
            "type": "string",
            "format": "date-time",
            "example": "2020-04-26T16:10:24.479"
          },
          "lastPublishedDate": {
            "description": "The date Privacy Notice was published on",
            "type": "string",
            "format": "date-time",
            "example": "2020-04-27T16:10:24.479"
          },
          "organizationId": {
            "description": "Unique Identifier of the Organization Privacy Notice belongs to",
            "type": "string",
            "format": "uuid",
            "example": "625ba071-61b0-485f-81a0-a2245777b430"
          },
          "responsibleUserId": {
            "description": "Unique Identifier identifying a Responsible User of the Privacy Notice",
            "type": "string",
            "format": "uuid",
            "example": "625ba071-61b0-485f-81a0-a2245777b435"
          },
          "version": {
            "description": "Version of the privacy notice which was active at the given date and time",
            "$ref": "#/components/schemas/PrivacyNoticeVersionDtoV2"
          }
        }
      }
    },
    "securitySchemes": {
      "OAUTH2": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://{hostname}/api/access/v1/oauth/token",
            "scopes": {
              "POLICY": "Policy scope for external systems"
            }
          }
        }
      }
    }
  }
}
```