---
title: "List queued deployments"
method: GET
path: "/environments/{environment}/queued-deployments"
tags: ["Deployments"]
---

# List queued deployments

`GET /environments/{environment}/queued-deployments`

## Request

- Base URL: `https://cloud.laravel.com/api`
- URL: `https://cloud.laravel.com/api/environments/{environment}/queued-deployments`
- Auth: HTTP bearer

Get a list of the deployments requested for the given environment while its resources were
still provisioning. Once a queued deployment is `promoted`, its `deployment` relationship is
the deployment it started.

## Path parameters

- `environment` string, required

## Query parameters

- `filter[status]` string
- `filter[commit_hash]` string
- `include` string[]

## Response `200`

Paginated set of `QueuedDeploymentResource`

- object
  - `data` QueuedDeploymentResource[], required
    - `id` string, required
    - `type` 'queuedDeployments', required
    - `attributes` object
      - `status` 'pending' | 'promoted' | 'failed' | 'expired' | 'cancelled', required
      - `branch_name` string, nullable, required
      - `commit_hash` string, required
      - `commit_message` string, required
      - `commit_author` string, nullable, required
      - `failure_reason` string, nullable, required: Why the queued deployment did not start.
      - `created_at` string, date-time, nullable, required
    - `relationships` object
      - `environment` object
        - `data` EnvironmentResourceIdentifier, required
          - `type` 'environments', required
          - `id` string, required
      - `initiator` object
        - `data` UserResourceIdentifier, required
          - `type` 'users', required
          - `id` string, required
      - `deployment` object
        - `data` DeploymentResourceIdentifier, required
          - `type` 'deployments', required
          - `id` string, required
  - `links` object, required
    - `first` string
    - `last` string
    - `prev` string
    - `next` string
  - `meta` object, required
    - `current_page` integer, required
    - `from` integer, nullable, required
    - `last_page` integer, required
    - `links` object[], required: Generated paginator links.
      - `url` string, nullable, required
      - `label` string, required
      - `active` boolean, required
    - `path` string, nullable, required: Base path for paginator generated URLs.
    - `per_page` integer, required: Number of items shown per page.
    - `to` integer, nullable, required: Number of the last item in the slice.
    - `total` integer, required: Total number of items being paginated.
  - `included` union[]
    - union
      - EnvironmentResource
        - `id` string, required
        - `type` 'environments', required
        - `attributes` object
          - `name` string, required
          - `slug` string, required
          - `status` 'deploying' | 'running' | 'hibernating' | 'stopped', required
          - `color` 'blue' | 'green' | 'orange' | 'purple' | 'red' | 'yellow' | 'cyan' | 'gray', required
          - `created_from_automation` boolean, required
          - `vanity_domain` string, required
          - `framework` 'laravel' | 'symfony' | 'jigsaw' | 'html' | 'php' | 'express' | 'hono' | 'nuxt' | 'next' | 'tanstack' | 'elysia' | 'nestjs' | 'astro' | 'javascript' | 'go' | 'hugo' | 'ruby' | 'rails' | 'jekyll' | 'django' | 'fastapi' | 'flask' | 'pelican' | 'python' | 'java' | 'spring' | 'rust' | 'zola' | 'axum' | 'rocket' | 'actix' | 'warp', required
          - `language` 'html' | 'php' | 'javascript' | 'python' | 'go' | 'ruby' | 'java' | 'rust', required
          - `php_major_version` string, required
          - `serving` string
          - `build_command` string, nullable, required
          - `node_version` '20' | '22' | '24' | '26', required
          - `deploy_command` string, nullable, required
          - `start_command` string, nullable, required
          - `uses_octane` boolean, required
          - `uses_hibernation` boolean, required
          - `hibernation_wake_up_interval` integer, nullable, required
          - `timeout` integer, required: The number of seconds the environment will wait for your application to respond before timing out. Changes take effect on the next deployment.
          - `shutdown_timeout` integer, required: The number of seconds to wait before stopping the previous deployment's compute instances, allowing it to finish processing requests and jobs after a new deployment becomes active. Changes take effect on the next deployment.
          - `uses_push_to_deploy` boolean, required
          - `uses_deploy_hook` boolean, required
          - `resend` object, nullable, required
            - `from_address` string, required
            - `from_name` string, required
            - `key_name` string, required
          - union
            - object
              - …
            - string[]
          - `network_settings` object, required
            - `cache` object, required
              - …
            - `response_headers` object, required
              - …
            - `firewall` object, required
              - …
            - `content_converter` boolean, required
          - `created_at` string, date-time, nullable, required
        - `relationships` object
          - `application` object
            - `data` ApplicationResourceIdentifier, required
              - …
          - `branch` object
            - `data` BranchResourceIdentifier, required
              - …
          - `deployments` object
            - `data` DeploymentResourceIdentifier[], required
              - …
          - `currentDeployment` object
            - `data` DeploymentResourceIdentifier, required
              - …
          - `domains` object
            - `data` DomainResourceIdentifier[], required
              - …
          - `primaryDomain` object
            - `data` DomainResourceIdentifier, required
              - …
          - `instances` object
            - `data` InstanceResourceIdentifier[], required
              - …
          - `database` object
            - `data` DatabaseSchemaResourceIdentifier, required
              - …
          - `cache` object
            - `data` CacheResourceIdentifier, required
              - …
          - `buckets` object
            - `data` FilesystemResourceIdentifier[], required
              - …
          - `websocketApplication` object
            - `data` WebsocketApplicationResourceIdentifier, required
              - …
          - `secrets` object
            - `data` SecretResourceIdentifier[], required
              - …
        - `links` object, required
          - `self` Link, required
            - `href` string, uri, required
            - `rel` string
            - `describedby` string
            - `title` string
            - `type` string
            - `hreflang` union
              - …
            - `meta` object
      - UserResource
        - `id` string, required
        - `type` 'users', required
        - `attributes` object
          - `name` string, required
          - `email` string, required
          - `avatar_url` string, required
          - `created_at` string, date-time, nullable, required
      - DeploymentResource
        - `id` string, required
        - `type` 'deployments', required
        - `attributes` object
          - `slug` string, required
          - `status` 'pending' | 'build.pending' | 'build.created' | 'build.queued' | 'build.running' | 'build.succeeded' | 'build.failed' | 'cancelled' | 'failed' | 'deployment.pending' | 'deployment.created' | 'deployment.queued' | 'deployment.running' | 'deployment.succeeded' | 'deployment.failed', required
          - `branch_name` string, required
          - `commit_hash` string, required
          - `commit_message` string, required
          - `commit_author` string, nullable, required
          - `failure_reason` string, nullable, required: Why the deployment did not finish. For `build.failed` and `deployment.failed`, the get deployment endpoint returns the output of the failed step, or a description when no failed step is found. The list endpoint returns the stored reason as is.
          - `php_major_version` string, required
          - `build_command` string, nullable, required
          - `node_version` '20' | '22' | '24' | '26', required
          - `uses_octane` boolean, required
          - `uses_hibernation` boolean, required
          - `hibernation_wake_up_interval` integer, nullable, required
          - `started_at` string, date-time, nullable, required
          - `finished_at` string, date-time, nullable, required
        - `relationships` object
          - `environment` object
            - `data` EnvironmentResourceIdentifier, required
              - …
          - `initiator` object
            - `data` UserResourceIdentifier, required
              - …
        - `links` object, required
          - `self` Link, required
            - `href` string, uri, required
            - `rel` string
            - `describedby` string
            - `title` string
            - `type` string
            - `hreflang` union
              - …
            - `meta` object

## Other responses

- `403`: Authorization error
- `404`: Not found

---

[API](https://skmtc.dev/laravel/apis/laravel-cloud.md) - [All operations](https://skmtc.dev/laravel/apis/laravel-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/laravel/apis/laravel-cloud/revisions/af603f54ff33?raw)