Last updated on 1st April 2026

Listing all projects via API

This method allows you to get a list of all projects.

Tip: You can explore and test this endpoint interactively using our OpenAPI documentation.

URL

/projects

HTTP Method

GET

Supported Parameters

None

Example cURL Request

curl -H "Content-type: application/json" \
-H "Accept: application/json" \
--user adam@atechmedia.com:my-api-key \
https://test.deployhq.com/projects/

Example Response

[
  {
    "name": "hgtest",
    "permalink": "hgtest",
    "identifier": "b8811674-79a7-4f1d-8bcc-935aab74f6e2",
    "zone": "us_east",
    "public_key": "ssh-rsa AAAB3NzaC1yc2EAAAADAQAN DeployHQ.com Key for hgtest",
    "repository": {
      "scm_type": "mercurial",
      "url": "ssh://hg@codebasehq.com/adamw/test/hgtest.hg",
      "port": null,
      "username": null,
      "branch": "default",
      "cached": true,
      "hosting_service": {
        "name": "Codebase",
        "url": "http://www.codebasehq.com",
        "tree_url": "https://adamw.codebasehq.com/projects/test/repositories/hgtest/tree/default",
        "commits_url": "https://adamw.codebasehq.com/projects/test/repositories/hgtest/commits/default"
      }
    },
    "repository_url": "ssh://hg@codebasehq.com/adamw/test/hgtest.hg",
    "last_deployed_at": null,
    "auto_deploy_url": "https://test.deployhq.com/deploy/hgtest/abc123",
    "url": "https://test.deployhq.com/projects/hgtest",
    "app_url": "https://test.deployhq.com/projects/hgtest",
    "servers_url": "https://test.deployhq.com/projects/hgtest/servers",
    "deployments_url": "https://test.deployhq.com/projects/hgtest/deployments",
    "config_files_url": "https://test.deployhq.com/projects/hgtest/config_files",
    "environment_variables_url": "https://test.deployhq.com/projects/hgtest/environment_variables",
    "build_commands_url": "https://test.deployhq.com/projects/hgtest/build_commands",
    "starred": false
  }
]