Skip to main content
Use this endpoint to retrieve the recent deployment history for your application. The API returns up to the last 10 deployments from the past 24 hours, with each deployment represented as an array of state-change events. This lets you trace the full lifecycle of a deployment — from pending through clone to success or error.

​
Endpoint

GET https://api.virtuscloud.app/v2/apps/{app_id}/deployments

​
Authorization

Include your API key in the request header: 
Authorization: <api_key>

​
Path Parameters

​
app_id
string
required
The unique identifier of your application. You can find this in the URL of your application’s dashboard.

​
Response

​
status
string
Indicates the outcome of the request. Returns "success" when the operation completes without errors.
​
response
array
An array of deployments. Each deployment is itself an array of state-event objects, ordered chronologically from earliest to latest state.

​
Examples

curl --request GET \
  --url "https://api.virtuscloud.app/v2/apps/{app_id}/deployments" \
  --header "Authorization: <api_key>"

​
Response Example

{
  "status": "success",
  "response": [
    [
      {
        "id": "git-393caedd68f5e5b771f6a027",
        "state": "pending",
        "date": "2023-10-16T20:27:20.513Z"
      },
      {
        "id": "git-393caedd68f5e5b771f6a027",
        "state": "clone",
        "date": "2023-10-16T20:27:20.536Z"
      },
      {
        "id": "git-393caedd68f5e5b771f6a027",
        "state": "success",
        "date": "2023-10-16T20:27:21.422Z"
      }
    ]
  ]
}
Results are limited to the last 10 deployments within the past 24 hours. Deployments older than 24 hours will not appear in this response.