---
title: "Get execution by executionId"
method: GET
path: "/apiops/promotion/executions/{executionId}"
tags: ["Promotion"]
---

# Get execution by executionId

`GET /apiops/promotion/executions/{executionId}`

## Request

- Base URL: `http://167.86.118.166:32080`
- URL: `http://167.86.118.166:32080/apiops/promotion/executions/{executionId}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/apinizer/apis/apinizer-management-apis/docs/apiops/promotion/executions/:executionId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns execution details by executionId (e.g. EXC-007).

## Path parameters

- `executionId` string, required

## Response `200`

successful operation!

- PromotionExecution
  - `id` string
  - `executionId` string
  - `mappingId` string
  - `mappingName` string
  - `sourceInstanceId` string
  - `sourceInstanceName` string
  - `sourceInstanceColor` string
  - `targetInstanceId` string
  - `targetInstanceName` string
  - `targetInstanceColor` string
  - `sourceApiName` string
  - `targetApiName` string
  - `status` 'PENDING' | 'APPROVAL_WAITING' | 'SCHEDULED' | 'RUNNING' | 'SUCCESS' | 'FAILED' | 'CANCELLED'
  - `approvalRequired` boolean
  - `approvedBy` string
  - `approvedAt` string, date-time
  - `scheduledAt` string, date-time
  - `progress` integer
  - `currentStep` integer
  - `totalSteps` integer
  - `steps` PromotionExecutionStep[]
    - `stepNumber` integer
    - `stepName` string
    - `status` 'PENDING' | 'APPROVAL_WAITING' | 'SCHEDULED' | 'RUNNING' | 'SUCCESS' | 'FAILED' | 'CANCELLED'
    - `message` string
    - `errorDetail` string
    - `startedAt` string, date-time
    - `completedAt` string, date-time
    - `durationMs` integer
    - `detailData` object[]
  - `executionName` string
  - `executionDescription` string
  - `executionNotes` string
  - `executedBy` string
  - `startedAt` string, date-time
  - `completedAt` string, date-time
  - `errorMessage` string
  - `errorDetail` string
  - `jsonDiff` JsonDiffEntry[]
    - `path` string
    - `type` string
    - `oldVal` unknown
    - `newVal` unknown
    - `complex` boolean
  - `approverUserIds` string[]
  - `durationMs` integer

## Other responses

- `401`: not authorized for this operation!
- `500`: internal error!

## Changes

- **2026-08-11** `9ae232e55479`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/apinizer/apis/apinizer-management-apis/changes/apiops/promotion/executions/:executionId/get.md)

---

[API](https://skmtc.dev/apinizer/apis/apinizer-management-apis.md) - [All operations](https://skmtc.dev/apinizer/apis/apinizer-management-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/apinizer/apis/apinizer-management-apis/revisions/e083046b24cd?raw)