Hugging Face hub

Hugging Face Commits API

A repository's commit history, page by page, with the message, date and authors of each commit.

GET /v1/hugging-face/repos/{repoType}/{owner}/{name}/commits

1 credit Failed requests are free

About this endpoint

GET /v1/hugging-face/repos/{repoType}/{owner}/{name}/commits returns repo, totalCount, the commits page and a numbered page block. Each commit has sha, title, message, committedAt and authors with username and avatarUrl.

revision selects a branch, tag or commit, limit accepts up to 50 and page is 1-based. lookupStatus is found, not_found or restricted; restricted means the repository exists but its history is gated.

Hugging Face Commits API FAQ

What does lookupStatus=restricted mean?

The repository exists but its history is not public. That is different from not_found, where no such repository is visible.

Can I read commits on a branch?

Yes. Pass revision as the branch name, tag or commit id. The default is the repository's default branch.

How many commits are on a page?

limit accepts 1 to 50 and defaults to 50. Use the page number to read older commits.

How much does a commit page cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.