--- title: Read One Promotion component: pingone-api-ea page_id: pingone-api-ea:platform:early-access/configuration-management/promotions/get-one-promotion canonical_url: https://developer.pingidentity.com/pingone-api-ea/platform/early-access/configuration-management/promotions/get-one-promotion.html section_ids: headers: Headers example-request: Example Request example-response: Example Response --- # Read One Promotion ##     ```none GET {{apiPath}}/v1/environments/{{envId}}/promotions/{{promotionID}} ``` Use the GET `{{apiPath}}/v1/environments/{{envId}}/promotions/{{promotionID}}` request to return the details for the specified promotion. Included in the response is the automatically generated promotion plan for the promotion. The promotion plan returned is a collection of promotion operations, though without the payload for each operation. The promotion plan either remains to be executed, or has already been executed if the promotion is completed. Refer to [Read Promotion Steps](get-promotion-steps.html) to get the promotion plan operations including the payload for each operation. ### Headers Authorization      Bearer {{accessToken}} ## ### Example Request * cURL * C# * Go * HTTP * Java * jQuery * NodeJS * Python * PHP * Ruby * Swift ```shell curl --location --globoff '{{apiPath}}/v1/environments/{{envId}}/promotions/{{promotionID}}' \ --header 'Authorization: Bearer {{accessToken}}' ``` ```csharp var options = new RestClientOptions("{{apiPath}}/v1/environments/{{envId}}/promotions/{{promotionID}}") { MaxTimeout = -1, }; var client = new RestClient(options); var request = new RestRequest("", Method.Get); request.AddHeader("Authorization", "Bearer {{accessToken}}"); RestResponse response = await client.ExecuteAsync(request); Console.WriteLine(response.Content); ``` ```golang package main import ( "fmt" "net/http" "io" ) func main() { url := "{{apiPath}}/v1/environments/{{envId}}/promotions/{{promotionID}}" method := "GET" client := &http.Client { } req, err := http.NewRequest(method, url, nil) if err != nil { fmt.Println(err) return } req.Header.Add("Authorization", "Bearer {{accessToken}}") res, err := client.Do(req) if err != nil { fmt.Println(err) return } defer res.Body.Close() body, err := io.ReadAll(res.Body) if err != nil { fmt.Println(err) return } fmt.Println(string(body)) } ``` ```http GET /v1/environments/{{envId}}/promotions/{{promotionID}} HTTP/1.1 Host: {{apiPath}} Authorization: Bearer {{accessToken}} ``` ```java OkHttpClient client = new OkHttpClient().newBuilder() .build(); MediaType mediaType = MediaType.parse("text/plain"); RequestBody body = RequestBody.create(mediaType, ""); Request request = new Request.Builder() .url("{{apiPath}}/v1/environments/{{envId}}/promotions/{{promotionID}}") .method("GET", body) .addHeader("Authorization", "Bearer {{accessToken}}") .build(); Response response = client.newCall(request).execute(); ``` ```javascript var settings = { "url": "{{apiPath}}/v1/environments/{{envId}}/promotions/{{promotionID}}", "method": "GET", "timeout": 0, "headers": { "Authorization": "Bearer {{accessToken}}" }, }; $.ajax(settings).done(function (response) { console.log(response); }); ``` ```javascript var request = require('request'); var options = { 'method': 'GET', 'url': '{{apiPath}}/v1/environments/{{envId}}/promotions/{{promotionID}}', 'headers': { 'Authorization': 'Bearer {{accessToken}}' } }; request(options, function (error, response) { if (error) throw new Error(error); console.log(response.body); }); ``` ```python import requests url = "{{apiPath}}/v1/environments/{{envId}}/promotions/{{promotionID}}" payload = {} headers = { 'Authorization': 'Bearer {{accessToken}}' } response = requests.request("GET", url, headers=headers, data=payload) print(response.text) ``` ```php setUrl('{{apiPath}}/v1/environments/{{envId}}/promotions/{{promotionID}}'); $request->setMethod(HTTP_Request2::METHOD_GET); $request->setConfig(array( 'follow_redirects' => TRUE )); $request->setHeader(array( 'Authorization' => 'Bearer {{accessToken}}' )); try { $response = $request->send(); if ($response->getStatus() == 200) { echo $response->getBody(); } else { echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' . $response->getReasonPhrase(); } } catch(HTTP_Request2_Exception $e) { echo 'Error: ' . $e->getMessage(); } ``` ```ruby require "uri" require "net/http" url = URI("{{apiPath}}/v1/environments/{{envId}}/promotions/{{promotionID}}") http = Net::HTTP.new(url.host, url.port); request = Net::HTTP::Get.new(url) request["Authorization"] = "Bearer {{accessToken}}" response = http.request(request) puts response.read_body ``` ```swift var request = URLRequest(url: URL(string: "{{apiPath}}/v1/environments/{{envId}}/promotions/{{promotionID}}")!,timeoutInterval: Double.infinity) request.addValue("Bearer {{accessToken}}", forHTTPHeaderField: "Authorization") request.httpMethod = "GET" let task = URLSession.shared.dataTask(with: request) { data, response, error in guard let data = data else { print(String(describing: error)) return } print(String(data: data, encoding: .utf8)!) } task.resume() ``` ### Example Response 200 OK ```json { "_links": { "self": { "href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/promotions/f2a2c7ac-3cc8-4d6a-b506-74fe3d416b2e" }, "environment": { "href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6" }, "targetEnvironment": { "href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6" }, "sourceSnapshot": { "href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/snapshots/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/versions/b958d5ec-07d9-4cf4-aef8-47060a55bc28" }, "targetSnapshot": { "href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/snapshots/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/versions/ef487a49-b27f-4845-b411-67c95b65eedb" }, "promotionSteps": { "href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/promotions/f2a2c7ac-3cc8-4d6a-b506-74fe3d416b2e/promotionSteps" } }, "id": "f2a2c7ac-3cc8-4d6a-b506-74fe3d416b2e", "createdAt": "2026-05-21T11:53:41.990Z", "updatedAt": "2026-05-21T11:53:41.990Z", "sourceEnvironmentId": "abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6", "sourceEnvironment": { "id": "abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6" }, "targetEnvironmentId": "abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6", "targetEnvironment": { "id": "abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6" }, "sourceSnapshotId": "b958d5ec-07d9-4cf4-aef8-47060a55bc28", "sourceSnapshot": { "id": "b958d5ec-07d9-4cf4-aef8-47060a55bc28" }, "targetSnapshotId": "ef487a49-b27f-4845-b411-67c95b65eedb", "targetSnapshot": { "id": "ef487a49-b27f-4845-b411-67c95b65eedb" }, "status": "NEW", "selectedResources": [ "26a126c2-054f-4f18-b077-8226c0c4bf3e" ], "excludedResources": [ "363ef235-f6fe-4bc7-ae3d-63217482f5" ], "resourceMapping": { "2c3b1245-2c38-4174-97fa-069d88a543b1": "c7c92d16-e07b-4ddb-8d17-073fea3a219c" }, "description": "Test promotion of population" } ```