# Get Policy Versions

GET /{policyId}

#### Description

Retrieves details of all policy versions linked to a specific policy, including version metadata, content, and associated documents or proof.

Endpoint: GET /
Version: 1.0
Security: oauth2

## Query parameters:

  - `policyId` (string, required)
    Gets policy versions by this policy ID.

## Response 200 fields (application/json):

  - `id` (string)
    Example: "d88d505d-5199-11ee-a644-522476618ae8"

  - `orgId` (string)
    Example: "ce83e3cd-5199-11ee-a644-522476618ae8"

  - `policyId` (string)
    Example: "85604927-8912-4471-8db6-480571dc78ce "

  - `documentId` (string)
    Example: "cf0bedbe-6ecd-46b1-a84e-07018f61c2aa"

  - `name` (string)
    Example: "Password Policy Version"

  - `ownerId` (string)
    Example: "82d7c228-8bcd-11e9-a94b-ab3de8494987"

  - `revisionStatus` (string)
    Enum: "approval", "draft", "effective", "retired"

  - `revisionStatusUpdatedBy` (string)
    Example: "82d7c228-8bcd-11e9-a94b-ab3de8494987"

  - `revisionStatusUpdatedOn` (string)
    Example: "2025-06-15T18:26:10.005365Z"

  - `nextRevisionDate` (string)
    Example: "2025-06-15T18:26:10.005365Z"

  - `nextReviewDate` (string)
    Example: "2025-06-16T18:26:10.005365Z"

  - `approvedDate` (string)
    Example: "2025-06-15T18:26:10.005365Z"

  - `retiredDate` (string)
    Example: "2025-06-15T18:26:10.005365Z"

  - `effectiveDate` (string)
    Example: "2025-06-12T18:26:10.005365Z"

  - `publishedUrl` (string)
    Example: "www.hyperproof.io"

  - `shareLink` (string)
    Example: "www.hyperproof.io"

  - `createdBy` (string)
    Example: "82d7c228-8bcd-11e9-a94b-ab3de8494987"

  - `createdOn` (string)
    Example: "2025-01-12T18:26:10.005365Z"

  - `updatedBy` (string)
    Example: "82d7c228-8bcd-11e9-a94b-ab3de8494987"

  - `updatedOn` (string)
    Example: "2025-01-12T18:26:10.005365Z"

  - `status` (string)
    The status of the object
    Enum: "active", "archived"

  - `permissions` (array)
    Example: []