Get file blame

Returns blame information for a file at a given repository path and optional git ref.

The response is split into two parts:

• ranges: contiguous, non-overlapping line ranges, each attributed to a single commit. Ordered by startLine.
• commits: commit metadata (hash, date, message, author, optional previous pointer for walking back through history) keyed by hash, deduplicated across ranges.

Whole-file renames are followed automatically. Cross-file line moves and copies are not.

GET /api/blame

Get file blame

cURL

curl --request GET \
  --url https://api.example.com/api/blame \
  --header 'Authorization: Bearer <token>'

200

{
  "ranges": [
    {
      "hash": "<string>",
      "path": "<string>",
      "startLine": 1,
      "lineCount": 1
    }
  ],
  "commits": {}
}

Authorizations

bearerTokenapiKeyHeader

Authorization · string · header · required

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

Query Parameters

path · string · required

The file path to blame, relative to the repository root.

repo · string · required

The fully-qualified repository name.

ref · string

The git ref (branch, tag, or commit SHA) to blame at. Defaults to the repository's default branch.

Response

200

application/json

Blame ranges and deduplicated commit metadata.

ranges · object[] · required

Contiguous, non-overlapping line ranges ordered by startLine. Each range is attributed to a single commit.

Show child attributes

commits · object · required

Commit metadata keyed by hash, deduplicated across ranges.

Show child attributes