> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Recent Deployments

> Retrieves the 20 most recent deployments for a specific application.

<ParamField path="app_id" type="string" required>
  The ID of the application whose recent deployments will be retrieved.
</ParamField>

### Response

<ResponseField name="response" type="array">
  An array of deployment objects.

  <Expandable title="Toggle object">
    <ResponseField name="app_id" type="string">
      The ID of the application.
    </ResponseField>

    <ResponseField name="commit_id" type="string">
      The commit ID of the deployment.
    </ResponseField>

    <ResponseField name="message" type="string">
      Commit message.
    </ResponseField>

    <ResponseField name="pusher" type="string">
      The username of the person who triggered the deployment.
    </ResponseField>

    <ResponseField name="branch" type="string">
      The branch that was deployed.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO timestamp of when the deployment occurred.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "response": [
      {
        "app_id": "123",
        "commit_id": "abc123",
        "message": "Fix deployment bug",
        "pusher": "user1",
        "branch": "main",
        "created_at": "2026-03-14T20:00:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>

### Error Responses

<ResponseField name="code" type="string">
  Possible error codes:

  * `UNAUTHORIZED`: User is not authenticated or lacks permissions.
  * `INTEGRATION_NOT_FOUND`: Application or deployments not found.
</ResponseField>

<ResponseField name="message" type="string">
  A descriptive message providing additional details about the error.
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "code": "INTEGRATION_NOT_FOUND"
  }
  ```
</ResponseExample>