List

View as Markdown

GET
/workspaces
/:workspace
/projects
/:project_name
/repository
/commits

Returns list of commits from the repository

Request

REQUIRED SCOPES

REPOSITORY_READ

URL PARAMETERS

workspacerequiredstring

The human-readable ID of the workspace

Example: "my-company"

project_namerequiredstring

The human-readable ID of the project

Example: "my-project"

GET PARAMETERS

pageinteger

The number of the successive pages (results are split into pages of per_page elements each).

Example: 1

per_pageinteger

Specifies the number of returned elements on the page. The default value is 20.

Example: 20

pathstring

Filter commits by file path

Example: "src/main.js"

branchstring

Filter commits by branch name

Example: "main"

authorstring

Filter commits by author name or email

Example: "john.doe@example.com"

sincestring

Filter commits since date (ISO 8601 format)

Example: "2025-01-01T00:00:00Z"

untilstring

Filter commits until date (ISO 8601 format)

Example: "2025-12-31T23:59:59Z"

revisionstring

SHA or branch/tag to start listing commits from. Default: the repository’s default branch (usually master)

Example: "c4afae9e62392c0b71f75fe571cbaa745b9b0aa5"

Response

RESPONSE BODY

urlread-onlystring

API endpoint to GET this object

html_urlread-onlystring

Web URL to view this object in Buddy.works

commitsShortCommitView[]

Last modified on Jan 26, 2026

Delete Compare

Request example

CURL
curl -X GET "https://api.buddy.works/workspaces/:workspace/projects/:project_name/repository/commits" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json"

EXAMPLE RESPONSE
{
  "url": "https://api.buddy.works/workspaces/my-workspace/projects/my-project/repository/commits",
  "html_url": "https://app.buddy.works/my-workspace/my-project/repository/commits",
  "commits": [
    {
      "url": "https://api.buddy.works/workspaces/my-workspace/projects/my-project/repository/commits/a089d82fe56335c8abd8790859bba925ad10f9d1",
      "html_url": "https://app.buddy.works/my-workspace/my-project/repository/commit/a089d82fe56335c8abd8790859bba925ad10f9d1",
      "revision": "a089d82fe56335c8abd8790859bba925ad10f9d1",
      "author_date": "2025-10-10T04:23:04Z",
      "commit_date": "2025-10-10T04:23:04Z",
      "message": "Added vitest-output.xml",
      "committer": {
        "url": "https://api.buddy.works/workspaces/my-workspace/members/1",
        "html_url": "https://app.buddy.works/my-workspace/-/profile/1",
        "id": 1,
        "name": "John Doe",
        "avatar_url": "https://app.buddy.works/image-server/user/0/0/0/0/0/0/1/d643744fbe5ebf2906a4d075a5b97110/w/32/32/AVATAR.png?ts=1760014081477",
        "email": "john.doe@company.com",
        "admin": true,
        "workspace_owner": true
      },
      "author": {
        "url": "https://api.buddy.works/workspaces/my-workspace/members/1",
        "html_url": "https://app.buddy.works/my-workspace/-/profile/1",
        "id": 1,
        "name": "John Doe",
        "avatar_url": "https://app.buddy.works/image-server/user/0/0/0/0/0/0/1/d643744fbe5ebf2906a4d075a5b97110/w/32/32/AVATAR.png?ts=1760014081477",
        "email": "john.doe@company.com",
        "admin": true,
        "workspace_owner": true
      }
    },
    {
      "url": "https://api.buddy.works/workspaces/my-workspace/projects/my-project/repository/commits/ced6de63ca555fad8d2290c1c158f87232ffd9e1",
      "html_url": "https://app.buddy.works/my-workspace/my-project/repository/commit/ced6de63ca555fad8d2290c1c158f87232ffd9e1",
      "revision": "ced6de63ca555fad8d2290c1c158f87232ffd9e1",
      "author_date": "2025-10-09T12:51:53Z",
      "commit_date": "2025-10-09T12:51:53Z",
      "message": "Changes to .bubby.yml",
      "committer": {
        "url": "https://api.buddy.works/workspaces/my-workspace/members/1",
        "html_url": "https://app.buddy.works/my-workspace/-/profile/1",
        "id": 1,
        "name": "John Doe",
        "avatar_url": "https://app.buddy.works/image-server/user/0/0/0/0/0/0/1/d643744fbe5ebf2906a4d075a5b97110/w/32/32/AVATAR.png?ts=1760014081477",
        "email": "john.doe@company.com",
        "admin": true,
        "workspace_owner": true
      },
      "author": {
        "url": "https://api.buddy.works/workspaces/my-workspace/members/1",
        "html_url": "https://app.buddy.works/my-workspace/-/profile/1",
        "id": 1,
        "name": "John Doe",
        "avatar_url": "https://app.buddy.works/image-server/user/0/0/0/0/0/0/1/d643744fbe5ebf2906a4d075a5b97110/w/32/32/AVATAR.png?ts=1760014081477",
        "email": "john.doe@company.com",
        "admin": true,
        "workspace_owner": true
      }
    }
  ]
}

STATUS
200 OK