Commit Endpoints

The Gitea API provides endpoints for retrieving commit information, including individual commits, commit lists, and commit diffs.

Get Single Commit

Retrieve a single commit by its SHA or git reference.

GET /repos/{owner}/{repo}/git/commits/{sha}

Path Parameters

string

required

Owner of the repository

string

required

Name of the repository

string

required

A git reference or commit SHA

Query Parameters

boolean

default:"true"

Include diff stats for the commit (disable for speedup)

boolean

default:"true"

Include verification information for the commit (disable for speedup)

boolean

default:"true"

Include list of affected files (disable for speedup)

Response

string

Commit SHA hash

string

API URL for the commit

string

Web URL to view the commit

object

Commit information

object

Author information

string

Author name

string

Author email

string

Author date (ISO 8601)

object

Committer information (same structure as author)

string

Commit message

object

Tree information

string

Tree SHA

string

API URL for the tree

object

Commit signature verification

boolean

Whether the signature is verified

string

Verification status reason

array

Array of parent commit metadata

array

Array of affected files

string

Path of the affected file

string

File status: added, modified, deleted

object

Commit statistics

integer

Total lines changed

integer

Lines added

integer

Lines deleted

curl -X GET "https://gitea.example.com/api/v1/repos/username/repo-name/git/commits/abc123" \
  -H "Authorization: token YOUR_TOKEN"

{
  "sha": "abc123def456",
  "url": "https://gitea.example.com/api/v1/repos/username/repo-name/git/commits/abc123def456",
  "html_url": "https://gitea.example.com/username/repo-name/commit/abc123def456",
  "commit": {
    "author": {
      "name": "John Doe",
      "email": "john@example.com",
      "date": "2024-03-10T12:00:00Z"
    },
    "committer": {
      "name": "John Doe",
      "email": "john@example.com",
      "date": "2024-03-10T12:00:00Z"
    },
    "message": "Add new feature",
    "tree": {
      "sha": "def789abc123",
      "url": "https://gitea.example.com/api/v1/repos/username/repo-name/git/trees/def789abc123"
    },
    "verification": {
      "verified": true,
      "reason": "valid"
    }
  },
  "parents": [
    {
      "sha": "parent123",
      "url": "https://gitea.example.com/api/v1/repos/username/repo-name/git/commits/parent123"
    }
  ],
  "files": [
    {
      "filename": "src/main.go",
      "status": "modified"
    }
  ],
  "stats": {
    "total": 15,
    "additions": 10,
    "deletions": 5
  }
}

List All Commits

Get a list of all commits from a repository.

GET /repos/{owner}/{repo}/commits

Path Parameters

string

required

Owner of the repository

string

required

Name of the repository

Query Parameters

string

SHA or branch to start listing commits from (usually ‘master’ or ‘main’)

string

Filepath of a file/directory to filter commits

string

Only commits after this date (ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ)

string

Only commits before this date (ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ)

boolean

default:"true"

Include diff stats for every commit

boolean

default:"true"

Include verification for every commit

boolean

default:"true"

Include list of affected files for every commit

string

Commits that match the given specifier will not be listed

integer

default:"1"

Page number of results (1-based)

integer

Page size of results (ignored if used with ‘path’)

Response

Returns an array of commit objects (same structure as Get Single Commit).

curl -X GET "https://gitea.example.com/api/v1/repos/username/repo-name/commits?sha=main&page=1&limit=10" \
  -H "Authorization: token YOUR_TOKEN"

curl -X GET "https://gitea.example.com/api/v1/repos/username/repo-name/commits?since=2024-03-01T00:00:00Z&until=2024-03-10T23:59:59Z" \
  -H "Authorization: token YOUR_TOKEN"

curl -X GET "https://gitea.example.com/api/v1/repos/username/repo-name/commits?path=src/main.go" \
  -H "Authorization: token YOUR_TOKEN"

[
  {
    "sha": "abc123def456",
    "commit": {
      "author": {
        "name": "John Doe",
        "email": "john@example.com",
        "date": "2024-03-10T12:00:00Z"
      },
      "message": "Add new feature"
    },
    "html_url": "https://gitea.example.com/username/repo-name/commit/abc123def456"
  },
  {
    "sha": "def456abc789",
    "commit": {
      "author": {
        "name": "Jane Smith",
        "email": "jane@example.com",
        "date": "2024-03-09T15:30:00Z"
      },
      "message": "Fix bug in authentication"
    },
    "html_url": "https://gitea.example.com/username/repo-name/commit/def456abc789"
  }
]

The response includes pagination headers:

X-Total-Count: Total number of commits
X-Page: Current page number
X-PerPage: Number of items per page
X-PageCount: Total number of pages
X-HasMore: Whether more pages exist

Download Commit Diff or Patch

Get a commit’s diff or patch file.

GET /repos/{owner}/{repo}/git/commits/{sha}.{diffType}

Path Parameters

string

required

Owner of the repository

string

required

Name of the repository

string

required

SHA of the commit to get

string

required

Output format: diff or patch

Response

Returns plain text diff or patch content.

curl -X GET "https://gitea.example.com/api/v1/repos/username/repo-name/git/commits/abc123.diff" \
  -H "Authorization: token YOUR_TOKEN"

curl -X GET "https://gitea.example.com/api/v1/repos/username/repo-name/git/commits/abc123.patch" \
  -H "Authorization: token YOUR_TOKEN"

diff --git a/src/main.go b/src/main.go
index 1234567..abcdefg 100644
--- a/src/main.go
+++ b/src/main.go
@@ -10,6 +10,7 @@ import (
 	"fmt"
 	"log"
 	"net/http"
+	"os"
 )
 
 func main() {

Get Commit Pull Request

Retrieve the pull request that merged this commit.

GET /repos/{owner}/{repo}/commits/{sha}/pull

Path Parameters

string

required

Owner of the repository

string

required

Name of the repository

string

required

SHA of the commit

Response

Returns a pull request object if the commit was part of a merged pull request.

integer

Pull request ID

integer

Pull request number

string

Pull request title

string

Pull request state: open, closed, merged

boolean

Whether the pull request was merged

string

Timestamp when merged (ISO 8601)

string

SHA of the merge commit

curl -X GET "https://gitea.example.com/api/v1/repos/username/repo-name/commits/abc123/pull" \
  -H "Authorization: token YOUR_TOKEN"

{
  "id": 42,
  "number": 10,
  "title": "Add new feature",
  "state": "closed",
  "merged": true,
  "merged_at": "2024-03-10T12:00:00Z",
  "merge_commit_sha": "abc123def456",
  "head": {
    "ref": "feature-branch",
    "sha": "def456abc789"
  },
  "base": {
    "ref": "main",
    "sha": "789abc123def"
  }
}

Common Use Cases

List Recent Commits

Get the most recent commits from the default branch:

curl -X GET "https://gitea.example.com/api/v1/repos/username/repo-name/commits?limit=20" \
  -H "Authorization: token YOUR_TOKEN"

Get Commits by Author

While the API doesn’t have a direct author filter, you can filter commits after fetching them or use the since parameter combined with knowing when the author was active.

Track File History

Get all commits that affected a specific file:

curl -X GET "https://gitea.example.com/api/v1/repos/username/repo-name/commits?path=src/main.go" \
  -H "Authorization: token YOUR_TOKEN"

Verify Commit Signatures

Include verification information for all commits:

curl -X GET "https://gitea.example.com/api/v1/repos/username/repo-name/commits?verification=true" \
  -H "Authorization: token YOUR_TOKEN"

Overview

Repositories

Issues & Pull Requests

Organizations & Teams

Users

Actions & Packages

Commit Endpoints

Get Single Commit

Path Parameters

Query Parameters

Response

List All Commits

Path Parameters

Query Parameters

Response

Download Commit Diff or Patch

Path Parameters

Response

Get Commit Pull Request

Path Parameters

Response

Common Use Cases

List Recent Commits

Get Commits by Author

Track File History

Verify Commit Signatures

​Get Single Commit

​Path Parameters

​Query Parameters

​Response

​List All Commits

​Path Parameters

​Query Parameters

​Response

​Download Commit Diff or Patch

​Path Parameters

​Response

​Get Commit Pull Request

​Path Parameters

​Response

​Common Use Cases

​List Recent Commits

​Get Commits by Author

​Track File History

​Verify Commit Signatures

Get Single Commit

Path Parameters

Query Parameters

Response

List All Commits

Path Parameters

Query Parameters

Response

Download Commit Diff or Patch

Path Parameters

Response

Get Commit Pull Request

Path Parameters

Response

Common Use Cases

List Recent Commits

Get Commits by Author

Track File History

Verify Commit Signatures