Skip to main content
GET
/
orgs
/
{organization}
/
servers
/
{server}
/
sites
/
{site}
/
deployments
List deployments
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://forge.laravel.com/api/orgs/{organization}/servers/{server}/sites/{site}/deployments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
{
  "data": [
    {
      "id": "<string>",
      "type": "deployments",
      "attributes": {
        "commit": {
          "hash": "<string>",
          "author": "<string>",
          "message": "<string>",
          "branch": "<string>"
        },
        "type": "<string>",
        "status": "cancelled",
        "started_at": "2025-07-29T09:00:00Z",
        "ended_at": "2025-07-29T09:00:00Z",
        "created_at": "2025-07-29T09:00:00Z",
        "updated_at": "2025-07-29T09:00:00Z"
      }
    }
  ],
  "links": {
    "first": "<string>",
    "last": "<string>",
    "prev": "<string>",
    "next": "<string>"
  },
  "meta": {
    "path": "<string>",
    "per_page": 123,
    "next_cursor": "<string>",
    "prev_cursor": "<string>"
  }
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

organization
string
required

The organization slug

server
integer
required

The server ID

site
integer
required

The site ID

Query Parameters

sort
string

Available sorts are created_at. You can sort by multiple options by separating them with a comma. To sort in descending order, use - sign in front of the sort, for example: -created_at.

page[size]
integer
default:30

The number of results that will be returned per page.

page[cursor]
string

The cursor to start the pagination from.

filter[commit_hash]
string

The commit hash of the deployment.

Examples:

"011118f"

filter[commit_message]
string

The commit message of the deployment.

Examples:

"WIP"

filter[commit_author]
string

The commit author of the deployment.

Examples:

"Taylor Otwell"

Response

Paginated set of DeploymentResource

data
DeploymentResource · object[]
required
meta
object
required
I