--- title: "Changes to Retrieve a run" method: GET path: "/api/v3/runs/{runId}" --- # Changes to Retrieve a run `GET /api/v3/runs/{runId}` > Every recorded change to this operation, newest first. ## Timeline Changed in 8 of 53 revisions. - **2025-09-10** `b3bb08191152`: 1 info - **2025-09-08** `f88f9449b635`: 1 breaking - **2025-03-21** `7e4036741e50`: 4 warning, 4 info - **2024-09-26** `9691a7335fb7`: 4 info - **2024-09-20** `9cfde2ecc119`: 7 breaking, 17 warning, 1 info - **2024-07-24** `059ad75e9ad0`: 6 info - **2024-07-01** `963d34ef81c4`: 1 warning, 1 info - **2024-06-26** `c80713ba9364`: 2 info ## Changes - **2025-09-10** `b3bb08191152`: 1 info - endpoint added - **2025-09-08** `f88f9449b635`: 1 breaking - api path removed without deprecation - **2025-03-21** `7e4036741e50`: 4 warning, 4 info - added the new `PENDING_VERSION` enum value to the `allOf[#/components/schemas/CommonRunObject]/status` response property for the response status `200` - added the new `PENDING_VERSION` enum value to the `allOf[subschema #2]/relatedRuns/children/items/status` response property for the response status `200` - added the new `PENDING_VERSION` enum value to the `allOf[subschema #2]/relatedRuns/parent/status` response property for the response status `200` - added the new `PENDING_VERSION` enum value to the `allOf[subschema #2]/relatedRuns/root/status` response property for the response status `200` - removed the `WAITING_FOR_DEPLOY` enum value from the `allOf[#/components/schemas/CommonRunObject]/status` response property for the response status `200` - removed the `WAITING_FOR_DEPLOY` enum value from the `allOf[subschema #2]/relatedRuns/children/items/status` response property for the response status `200` - removed the `WAITING_FOR_DEPLOY` enum value from the `allOf[subschema #2]/relatedRuns/parent/status` response property for the response status `200` - removed the `WAITING_FOR_DEPLOY` enum value from the `allOf[subschema #2]/relatedRuns/root/status` response property for the response status `200` - **2024-09-26** `9691a7335fb7`: 4 info - added the optional property `allOf[#/components/schemas/CommonRunObject]/metadata` to the response with the `200` status - added the optional property `allOf[subschema #2]/relatedRuns/children/items/metadata` to the response with the `200` status - added the optional property `allOf[subschema #2]/relatedRuns/parent/metadata` to the response with the `200` status - added the optional property `allOf[subschema #2]/relatedRuns/root/metadata` to the response with the `200` status - **2024-09-20** `9cfde2ecc119`: 7 breaking, 17 warning, 1 info - the response's body type changed from `object` to no type for status `200` - removed the required property `attempts` from the response with the `200` status - removed the required property `createdAt` from the response with the `200` status - removed the required property `id` from the response with the `200` status - removed the required property `status` from the response with the `200` status - removed the required property `taskIdentifier` from the response with the `200` status - removed the required property `updatedAt` from the response with the `200` status - removed the optional property `baseCostInCents` from the response with the `200` status - removed the optional property `costInCents` from the response with the `200` status - removed the optional property `delayedUntil` from the response with the `200` status - removed the optional property `durationMs` from the response with the `200` status - removed the optional property `expiredAt` from the response with the `200` status - removed the optional property `finishedAt` from the response with the `200` status - removed the optional property `idempotencyKey` from the response with the `200` status - removed the optional property `isTest` from the response with the `200` status - removed the optional property `output` from the response with the `200` status - removed the optional property `outputPresignedUrl` from the response with the `200` status - removed the optional property `payload` from the response with the `200` status - removed the optional property `payloadPresignedUrl` from the response with the `200` status - removed the optional property `schedule` from the response with the `200` status - removed the optional property `startedAt` from the response with the `200` status - removed the optional property `tags` from the response with the `200` status - removed the optional property `ttl` from the response with the `200` status - removed the optional property `version` from the response with the `200` status - added `#/components/schemas/CommonRunObject, subschema #2` to the response body `allOf` list for the response status `200` - **2024-07-24** `059ad75e9ad0`: 6 info - added the optional property `baseCostInCents` to the response with the `200` status - added the optional property `costInCents` to the response with the `200` status - added the optional property `durationMs` to the response with the `200` status - added the optional property `expiredAt` to the response with the `200` status - added the optional property `tags` to the response with the `200` status - added the optional property `ttl` to the response with the `200` status - **2024-07-01** `963d34ef81c4`: 1 warning, 1 info - added the new `DELAYED` enum value to the `status` response property for the response status `200` - added the optional property `delayedUntil` to the response with the `200` status - **2024-06-26** `c80713ba9364`: 2 info - added the optional property `outputPresignedUrl` to the response with the `200` status - added the optional property `payloadPresignedUrl` to the response with the `200` status --- [Operation](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/docs/api/v3/runs/:runId/get.md) - [API](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api.md) - [Page](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/changes/api/v3/runs/:runId/get)