getBlame()

const blame = await repo.getBlame({
  path: 'src/api/auth.ts',
  ref: 'main',
});

console.log(`${blame.path} @ ${blame.commitSha}`);
for (const line of blame.lines) {
  console.log(
    `${line.lineNumber}\t${line.commitSha.slice(0, 8)}\t${line.authorName}\t${line.summary}`,
  );
}

// Range + rename detection
const range = await repo.getBlame({
  path: 'src/api/auth.ts',
  ref: 'main',
  ranges: ['10,40'],
  detectMoves: true,
});

blame = await repo.get_blame(
    path="src/api/auth.py",
    ref="main",
)

print(f"{blame['path']} @ {blame['commit_sha']}")
for line in blame["lines"]:
    print(
        f"{line['line_number']}\t{line['commit_sha'][:8]}\t"
        f"{line['author_name']}\t{line['summary']}"
    )

# Range + rename detection
range_blame = await repo.get_blame(
    path="src/api/auth.py",
    ref="main",
    ranges=["10,40"],
    detect_moves=True,
)

blame, err := repo.GetBlame(context.Background(), storage.BlameOptions{
    Path: "src/api/auth.go",
    Ref:  "main",
})
if err != nil {
    log.Fatal(err)
}

fmt.Printf("%s @ %s\n", blame.Path, blame.CommitSHA)
for _, line := range blame.Lines {
    fmt.Printf("%d\t%s\t%s\t%s\n",
        line.LineNumber, line.CommitSHA[:8], line.AuthorName, line.Summary)
}

// Range + rename detection
rangeBlame, err := repo.GetBlame(context.Background(), storage.BlameOptions{
    Path:        "src/api/auth.go",
    Ref:         "main",
    Ranges:      []string{"10,40"},
    DetectMoves: true,
})

​

Options

​

Response

• lineNumber — 1-based line number in the file at ref
• commitSha — commit that last touched the line
• originalLineNumber — line number in the originating commit (differs after edits)
• originalPath — path in the originating commit (differs after renames when detectMoves is on)
• previousCommitSha — parent commit that touched the line; omitted for the initial commit
• authorName, authorEmail
• authorTime (parsed Date in TypeScript, datetime in Python, time.Time in Go)
• rawAuthorTime — RFC 3339 string as returned by the server
• committerName, committerEmail, committerTime, rawCommitterTime
• summary — first line of the commit message

​

Notes

• Commit metadata is duplicated per line in the SDK result; if you need a deduped commit map, group by commitSha client-side.
• Each ranges entry is one git blame -L argument. Supported forms: a single line "10", a numeric range "10,20", an offset "10,+5" / "10,-5", a regex "/getUser/", a regex pair "/start/,/end/", regex + offset "/start/,+30", half-open ranges "10," and ",20", and ":funcname" for function-body targeting. Line numbers are 1-based and inclusive; ranges that resolve to lines outside the file return a 400, not a silent clamp. Up to 16 specs per request, each capped at 256 characters (regex content capped at 200).
• Annotated tags are peeled to the underlying commit, so commitSha always equals the dereferenced commit (git rev-parse <ref>^{}).
• Symlinks blame as a single line of the link-target text. Binary files (including ones that cross git’s 8 KiB heuristic via embedded NUL bytes) are blamed as text.
• path may not contain NUL bytes.