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

# List Deployments

> Get the last 10 deployments of an application from the last 24 hours.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  The API key for your account. You can find this in your [account settings](https://squarecloud.app/en/account/security).
</ParamField>

Use this endpoint to inspect what happened during recent deploys: each inner array captures one deploy attempt's lifecycle, moving through `pending`, `clone` (Git-driven deploys only), `commit`, `restarting`, and `success` states. Every event carries a derived `source` field: `git` when the deploy came from a webhook or GitHub App push, `upload` when it came from a zip upload or a [Commit Application](/en/api-reference/endpoint/apps/commit) call.

The deploy log comes from a short-lived cluster cache, so it only reflects the application's most recent activity and returns an empty array once nothing remains recorded. To check the currently configured Git integration instead of past deploy attempts, see [Get Current Deployment](/en/api-reference/endpoint/apps/deploy/info).

### Parameters

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  The ID of the application. You can find this in the URL of your application's dashboard.
</ParamField>

### Response

<ResponseField name="status" type="string">
  Indicates whether the call was successful.. `success` if successful, `error` if not.
</ResponseField>

<ResponseField name="response" type="array">
  The contents of the response.

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

    <ResponseField name="state" type="string">
      The state of the deploy. Can be `pending`, `clone`, `success`, or `error`.
    </ResponseField>

    <ResponseField name="date" type="string">
      The date the deploy was created.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
      "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"
  		    }
  	    ]
      ],
  }
  ```
</ResponseExample>