| CARVIEW |
Select Language
HTTP/2 302
server: nginx
date: Tue, 26 Aug 2025 10:45:44 GMT
content-type: text/plain; charset=utf-8
content-length: 0
x-archive-redirect-reason: found capture at 20160702002001
location: https://web.archive.org/web/20160702002001/https://developer.github.com/v3/git/commits/
server-timing: captures_list;dur=0.512945, exclusion.robots;dur=0.019341, exclusion.robots.policy;dur=0.008877, esindex;dur=0.010528, cdx.remote;dur=7.571464, LoadShardBlock;dur=175.856166, PetaboxLoader3.datanode;dur=49.739836, PetaboxLoader3.resolve;dur=54.088139
x-app-server: wwwb-app204
x-ts: 302
x-tr: 207
server-timing: TR;dur=0,Tw;dur=0,Tc;dur=1
set-cookie: wb-p-SERVER=wwwb-app204; path=/
x-location: All
x-rl: 0
x-na: 0
x-page-cache: MISS
server-timing: MISS
x-nid: DigitalOcean
referrer-policy: no-referrer-when-downgrade
permissions-policy: interest-cohort=()
HTTP/2 200
server: nginx
date: Tue, 26 Aug 2025 10:45:45 GMT
content-type: text/html; charset=utf-8
x-archive-orig-server: GitHub.com
x-archive-orig-last-modified: Thu, 30 Jun 2016 19:36:11 GMT
x-archive-orig-access-control-allow-origin: *
x-archive-orig-expires: Sat, 02 Jul 2016 00:30:01 GMT
x-archive-orig-cache-control: max-age=600
x-archive-orig-x-github-request-id: 17EB2F18:6485:1687E0:577708B1
x-archive-orig-content-length: 32867
x-archive-orig-accept-ranges: bytes
x-archive-orig-date: Sat, 02 Jul 2016 00:20:01 GMT
x-archive-orig-via: 1.1 varnish
x-archive-orig-age: 0
x-archive-orig-connection: close
x-archive-orig-x-served-by: cache-sjc3126-SJC
x-archive-orig-x-cache: MISS
x-archive-orig-x-cache-hits: 0
x-archive-orig-vary: Accept-Encoding
x-archive-orig-x-fastly-request-id: 0da425690a9b8bb975dc565fd65dddd782ef862c
x-archive-guessed-content-type: text/html
x-archive-guessed-charset: utf-8
memento-datetime: Sat, 02 Jul 2016 00:20:01 GMT
link: Git Commits | GitHub Developer Guide
The
The
Commits
Get a Commit
GET /repos/:owner/:repo/git/commits/:sha
Response
Status: 200 OK
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
{
"sha": "7638417db6d59f3c431d3e1f261cc637155684cd",
"url": "https://api.github.com/repos/octocat/Hello-World/git/commits/7638417db6d59f3c431d3e1f261cc637155684cd",
"author": {
"date": "2014-11-07T22:01:45Z",
"name": "Scott Chacon",
"email": "schacon@gmail.com"
},
"committer": {
"date": "2014-11-07T22:01:45Z",
"name": "Scott Chacon",
"email": "schacon@gmail.com"
},
"message": "added readme, because im a good github citizen\n",
"tree": {
"url": "https://api.github.com/repos/octocat/Hello-World/git/trees/691272480426f78a0138979dd3ce63b77f706feb",
"sha": "691272480426f78a0138979dd3ce63b77f706feb"
},
"parents": [
{
"url": "https://api.github.com/repos/octocat/Hello-World/git/commits/1acc419d4d6a9ce985db7be48c6349a0475975b5",
"sha": "1acc419d4d6a9ce985db7be48c6349a0475975b5"
}
]
}
Create a Commit
POST /repos/:owner/:repo/git/commits
Parameters
| Name | Type | Description |
|---|---|---|
message |
string |
Required. The commit message |
tree |
string |
Required. The SHA of the tree object this commit points to |
parents |
array of strings |
Required. The SHAs of the commits that were the parents of this commit. If omitted or empty, the commit will be written as a root commit. For a single parent, an array of one SHA should be provided; for a merge commit, an array of more than one should be provided. |
Optional Parameters
You can provide an additional committer parameter, which is an object containing
information about the committer. Or, you can provide an author parameter, which
is an object containing information about the author.
The committer section is optional and will be filled with the author
data if omitted. If the author section is omitted, it will be filled
in with the authenticated user's information and the current date.
Both the author and committer parameters have the same keys:
| Name | Type | Description |
|---|---|---|
name |
string |
The name of the author (or committer) of the commit |
email |
string |
The email of the author (or committer) of the commit |
date |
string |
Indicates when this commit was authored (or committed). This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. |
Example Input
{
"message": "my commit message",
"author": {
"name": "Scott Chacon",
"email": "schacon@gmail.com",
"date": "2008-07-09T16:13:30+12:00"
},
"parents": [
"7d1b31e74ee336d15cbd21741bc88a537ed063a0"
],
"tree": "827efc6d56897b048c772eb4087f854f46256132"
}
Response
Status: 201 Created
Location: https://api.github.com/repos/octocat/Hello-World/git/commits/7638417db6d59f3c431d3e1f261cc637155684cd
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
{
"sha": "7638417db6d59f3c431d3e1f261cc637155684cd",
"url": "https://api.github.com/repos/octocat/Hello-World/git/commits/7638417db6d59f3c431d3e1f261cc637155684cd",
"author": {
"date": "2014-11-07T22:01:45Z",
"name": "Scott Chacon",
"email": "schacon@gmail.com"
},
"committer": {
"date": "2014-11-07T22:01:45Z",
"name": "Scott Chacon",
"email": "schacon@gmail.com"
},
"message": "my commit message",
"tree": {
"url": "https://api.github.com/repos/octocat/Hello-World/git/trees/827efc6d56897b048c772eb4087f854f46256132",
"sha": "827efc6d56897b048c772eb4087f854f46256132"
},
"parents": [
{
"url": "https://api.github.com/repos/octocat/Hello-World/git/commits/7d1b31e74ee336d15cbd21741bc88a537ed063a0",
"sha": "7d1b31e74ee336d15cbd21741bc88a537ed063a0"
}
]
}
Commit signature verification
Commit response objects including signature verification data are currently available for developers to preview. During the preview period, the object formats may change without advance notice. Please see the blog post for full details.
To receive signature verification data in commit objects you must provide a custom media type in the Accept header:
application/vnd.github.cryptographer-preview
GET /repos/:owner/:repo/git/commits/:sha
Response
Status: 200 OK
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
{
"sha": "7638417db6d59f3c431d3e1f261cc637155684cd",
"url": "https://api.github.com/repos/octocat/Hello-World/git/commits/7638417db6d59f3c431d3e1f261cc637155684cd",
"author": {
"date": "2014-11-07T22:01:45Z",
"name": "Scott Chacon",
"email": "schacon@gmail.com"
},
"committer": {
"date": "2014-11-07T22:01:45Z",
"name": "Scott Chacon",
"email": "schacon@gmail.com"
},
"message": "added readme, because im a good github citizen\n",
"tree": {
"url": "https://api.github.com/repos/octocat/Hello-World/git/trees/691272480426f78a0138979dd3ce63b77f706feb",
"sha": "691272480426f78a0138979dd3ce63b77f706feb"
},
"parents": [
{
"url": "https://api.github.com/repos/octocat/Hello-World/git/commits/1acc419d4d6a9ce985db7be48c6349a0475975b5",
"sha": "1acc419d4d6a9ce985db7be48c6349a0475975b5"
}
],
"verification": {
"verified": true,
"reason": "valid",
"signature": "-----BEGIN PGP MESSAGE-----\n...\n-----END PGP MESSAGE-----",
"payload": "tree 691272480426f78a0138979dd3ce63b77f706feb\n..."
}
}
The verification object
The response will include a verification field whose value is an object describing the result of verifying the commit's signature. The following fields are included in the verification object:
| Name | Type | Description |
|---|---|---|
verified |
boolean |
Does GitHub consider the signature in this commit to be verified? |
reason |
string |
The reason for verified value. Possible values and their meanings are enumerated in the table below. |
signature |
string |
The signature that was extracted from the commit. |
payload |
string |
The value that was signed. |
The reason field
The following are possible reasons that may be included in the verification object:
| Value | Description |
|---|---|
expired_key |
The key that made the signature is expired. |
not_signing_key |
The "signing" flag is not among the usage flags in the GPG key that made the signature. |
gpgverify_error |
There was an error communicating with the signature-verification service. |
gpgverify_unavailable |
The signature-verification service is currently unavailable. |
unsigned |
The object does not include a signature. |
unknown_signature_type |
A non-PGP signature was found in the commit. |
no_user |
No user was associated with the committer email address in the commit. |
unverified_email |
The committer email address in the commit was associated with a user, but the email address is not verified on her/his account. |
bad_email |
The committer email address in the commit is not included in the identities of the PGP key that made the signature. |
unknown_key |
The key that made the signature has not been registered with any user's account. |
malformed_signature |
There was an error parsing the signature. |
invalid |
The signature could not be cryptographically verified using the key whose key-id was found in the signature. |
valid |
None of the above errors applied, so the signature is considered to be verified. |
This website is a public GitHub repository. Please help us by forking the project and adding to it.