View recent commits via API

Last updated on 12th November 2025

This method allows you to view up to 15 most recent revisions and up to 15 most recent tags in a specific branch in the connected repository.

Note: If you've recently added new tags to your repository, you may need to refresh your repository cache in DeployHQ to see them. Click the refresh button next to your repository on the deployment page or in the repository configuration to fetch the latest tags.

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

URL

/projects/<project>/repository/recent_commits

Replace <project> with either the permalink or identifier of the project.

HTTP Method

GET

Supported Parameters

branch - the name of the branch you wish to view recent revisions for (required)

Example cURL Request

curl -H "Content-type: application/json" \
-H "Accept: application/json" \
--user adam@atechmedia.com:my-api-key \
-d { \
  "branch" : "master" \ 
} \
https://test.deployhq.com/projects/project/repository/commit_info

Example Response

{
  "commits": [
    {
      "ref": "1363572112b5544a3656214023bd5a9ac7e5cc19",
      "author": "Adam West",
      "email": "adamw@atech.media",
      "timestamp": "2018-03-12T09:42:50.000+00:00",
      "message": "Test commit '",
      "short_message": "Test commit '",
      "tags": []
    },
    {
      "ref": "dd9ff27c505bd272bec8c625b9cd2d78fccae0c5",
      "author": "Dan Wentworth",
      "email": "dan@atechmedia.com",
      "timestamp": "2017-09-28T16:21:52.000+01:00",
      "message": "dw 2017 2",
      "short_message": "dw 2017 2",
      "tags": []
    },
  ],
  "tags": {
    "annotated": "00b8be80892ffa53a1a0aa2dc1a473944aaba6bc",
    "tag1": "cf098dd42c6cc76fd73200fa970c7c2eaf3d5b43",
  }
}