---
title: "GET /environments/{environmentID}/snapshots/{snapshotID}/versions"
method: GET
path: "/environments/{environmentID}/snapshots/{snapshotID}/versions"
tags: ["Configuration Management", "Snapshots"]
---

# GET /environments/{environmentID}/snapshots/{snapshotID}/versions

`GET /environments/{environmentID}/snapshots/{snapshotID}/versions`

## Request

- Base URL: `https://api.pingone.com/v1`
- URL: `https://api.pingone.com/v1/environments/{environmentID}/snapshots/{snapshotID}/versions`
- Auth: none declared
- TypeScript: <https://skmtc.dev/pingidentity/apis/pingone-platform-api/docs/environments/:environmentID/snapshots/:snapshotID/versions/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `environmentID` string, uuid, required
- `snapshotID` string, uuid, required

## Headers

- `X-Ping-External-Session-ID` string
- `X-Ping-External-Transaction-ID` string

## Response `200`

OK

- ComPingidentityPingoneConfigmanagementSnapshotsDataSnapshotsVersionsResponse
  - `_embedded` object
    - `versions` ComPingidentityPingoneConfigmanagementSnapshotsDataSnapshotView[]
      - `_embedded` object
      - `_links` object
        - `self` ComPingidentityApiResponseLink
          - `href` string, uri, required
          - `name` string
          - `profile` string, uri
          - `title` string, uri
          - `type` string
      - `completedAt` string, date-time
      - `configuration` string
      - `createdAt` string, date-time
      - `environment` ComPingidentityApiRelationshipPingOneRO
        - `id` string, uuid, required
      - `error` string
      - `errorCode` integer
      - `id` string, uuid
      - `importMetadata` object
      - `referencedResources` string[]
      - `resource` ComPingidentityPingoneConfigmanagementSnapshotsDataResourceInformation
        - `category` string
        - `id` string
        - `name` string
      - `resourceUrl` string
      - `snapshotId` string, uuid
      - `startedAt` string, date-time
      - `status` 'COMPLETE' | 'ERROR' | 'IN_PROGRESS' | 'WAITING'
      - `versionedAt` string, date-time
  - `_links` object
    - `self` ComPingidentityApiResponseLink
      - `href` string, uri, required
      - `name` string
      - `profile` string, uri
      - `title` string, uri
      - `type` string
  - `count` integer
  - `size` integer

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden - Note: This may occur if the environment doesn't exist. Check for environment existence with GET /environments/{environmentID} first.
- `429`: Too Many Requests
- `500`: Internal Server Error
- `502`: Bad Gateway
- `503`: Service Unavailable

## Changes

- **2025-12-01** (3.1) `f9637bc63214`: 2 info
  - added the optional property `details/items/innerError/supportedAttributes` to the response with the `400` status
  - added the optional property `details/items/innerError/supportedOperators` to the response with the `400` status
- **2025-11-18** (3.1) `140cd773d2bc`: 2 breaking
  - the response property `id` became optional for the status `429`
  - the `id` response property's minLength was decreased from `1` to `0` for the response status `429`
- **2025-10-29** (3.1) `3127cc323399`: 2 info
  - added the optional property `_embedded/versions/items/allOf[subschema #1: Snapshot View]/errorCode` to the response with the `200` status (media type: application/hal+json)
  - added the optional property `_embedded/versions/items/allOf[subschema #1: Snapshot View]/errorCode` to the response with the `200` status (media type: application/json)

[Operation history](https://skmtc.dev/pingidentity/apis/pingone-platform-api/changes/environments/:environmentID/snapshots/:snapshotID/versions/get.md)

---

[API](https://skmtc.dev/pingidentity/apis/pingone-platform-api.md) - [All operations](https://skmtc.dev/pingidentity/apis/pingone-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pingidentity/apis/pingone-platform-api/revisions/06f0006b7426?raw)