---
title: Release information
description: Advanced Identity Cloud tenant environments each provide the following information about their status in the release process:
component: pingoneaic
page_id: pingoneaic:tenants:environments-release-information
canonical_url: https://docs.pingidentity.com/pingoneaic/tenants/environments-release-information.html
section_ids:
  view-release-information-using-the-ui: View release information using the admin console
  view-release-information-using-the-api: View release information using the API
  release-api-endpoint: Release API endpoint
  authenticate-to-the-release-api-endpoint: Authenticate to the release API endpoint
  view-release-information: View release information
---

# Release information

Advanced Identity Cloud tenant environments each provide the following information about their status in the [release process](../release-notes/release-process.html):

* The current [release version](../release-notes/release-process.html#release-versions) for that environment. This is available in all tenant environments.

* The date and time of the next scheduled [regular channel](../release-notes/release-process.html#regular-channel) release to that environment. This is available in tenant environments that share promoted configuration (development, UAT\[[1](#_footnotedef_1 "View footnote.")], staging, and production).

## View release information using the admin console

The easiest way to view release information about your tenant environments is to use the admin console.

1. In the Advanced Identity Cloud admin console, open the TENANT menu (upper right), then go to [icon: settings, set=material, size=inline] Tenant Settings > Details.

2. View the current release version under Identity Cloud Version.

   |   |                                                                                                                                                                              |
   | - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   |   | You can also view the release version in the page footnotes at the bottom of most admin console pages, excluding editors (for example, the journey or hosted pages editors). |

3. View the next regular channel release date and time in the banner at the top of the page.

## View release information using the API

You can use the API to view release information about your tenant environments. You might want to do this for these reasons:

* To create monitoring alerts when release information changes.

* To track the release information of your tenant environments in a single dashboard.

* To track the 7-day [release deferral](../release-notes/release-deferral.html) period for the next regular channel release to your production environment.

### Release API endpoint

Advanced Identity Cloud provides the [Release API endpoint](https://docs.pingidentity.com/pingoneaic/_attachments/api/#tag/Release) to let you track release information.

### Authenticate to the release API endpoint

To authenticate to the release API endpoint, use an [access token](../developer-docs/authenticate-to-rest-api-with-access-token.html) created with the following scope:

| Scope              | Description                              |
| ------------------ | ---------------------------------------- |
| `fr:idc:release:*` | Full access to the release API endpoint. |

### View release information

To view the release information in any tenant environment:

1. [Get an access token](../developer-docs/authenticate-to-rest-api-with-access-token.html#get_an_access_token) created with the `fr:idc:release:*` scope.

2. Get the release information from the `/environment/release` endpoint:

   ```none
   $ curl \
   --request GET 'https://<tenant-env-fqdn>/environment/release' \(1)
   --header 'Authorization: Bearer <access-token>' (2)
   ```

   |       |                                                                      |
   | ----- | -------------------------------------------------------------------- |
   | **1** | Replace \<tenant-env-fqdn> with the FQDN of your tenant environment. |
   | **2** | Replace \<access-token> with the access token.                       |

3. The response format depends on the type of tenant environment:

   * For sandbox\[[2](#_footnotedef_2 "View footnote.")] environments:

     > **Collapse: Show response**
     >
     > ```json
     > {
     >     "currentVersion": "15374.0", (1)
     > }
     > ```
     >
     > |       |                                                        |
     > | ----- | ------------------------------------------------------ |
     > | **1** | The current release version of the tenant environment. |

   * For environments that share promoted configuration (development, UAT\[[1](#_footnotedef_1 "View footnote.")], staging, and production):

     > **Collapse: Show response**
     >
     > ```json
     > {
     >     "currentVersion": "15158.7", (1)
     >     "nextUpgrade": "2024-10-29T14:00:00Z" (2)
     > }
     > ```
     >
     > |       |                                                                                                                                                                                              |
     > | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
     > | **1** | The current release version of the tenant environment.                                                                                                                                       |
     > | **2** | The date and time of the next scheduled regular channel release to the tenant environment, taking into account your 7-day [release deferral](../release-notes/release-deferral.html) period. |

***

[1](#_footnoteref_1). A [user acceptance testing (UAT) environment](environments-uat.html) is an [add-on capability](../product-information/add-on-capabilities.html).[2](#_footnoteref_2). A [sandbox environment](environments-sandbox.html) is an [add-on capability](../product-information/add-on-capabilities.html).