Skip to main content
GET
/
api
/
commits
List commits
curl --request GET \
  --url https://api.example.com/api/commits \
  --header 'Authorization: Bearer <token>'
[
  {
    "hash": "<string>",
    "date": "<string>",
    "message": "<string>",
    "refs": "<string>",
    "body": "<string>",
    "authorName": "<string>",
    "authorEmail": "<string>"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.sourcebot.dev/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your API key.

Query Parameters

​
repo
string
required

The fully-qualified repository name.

​
query
string

Filter commits by message content (case-insensitive). Interpreted as a POSIX BRE regex — escape metacharacters for literal matching.

​
since
string

Return commits after this date. Accepts ISO 8601 or relative formats (e.g. 30 days ago).

​
until
string

Return commits before this date. Accepts ISO 8601 or relative formats.

​
author
string

Filter commits by author name or email (case-insensitive). Interpreted as a POSIX BRE regex — escape metacharacters for literal matching.

​
ref
string

The git ref (branch, tag, or commit SHA) to list commits from. Defaults to HEAD.

​
path
string

Restrict commits to those that touch this file path.

​
page
integer
default:1
Required range: x > 0
​
perPage
integer
default:50
Required range: 0 < x <= 100

Response

Paginated commit list.

​
hash
string
required

The full commit SHA.

​
date
string
required

The commit date in ISO 8601 format.

​
message
string
required

The commit subject line.

​
refs
string
required

Refs pointing to this commit (e.g. branch or tag names).

​
body
string
required

The commit body (everything after the subject line).

​
authorName
string
required
​
authorEmail
string
required