> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Commits

**Signature verification object**

The response will include a `verification` object that describes the result of verifying the commit's signature. The following fields are included in the `verification` object:

| Name | Type | Description |
| - | - | - |
| `verified` | `boolean` | Indicates whether GitHub considers the signature in this commit to be verified. |
| `reason` | `string` | The reason for verified value. Possible values and their meanings are enumerated in table below. |
| `signature` | `string` | The signature that was extracted from the commit. |
| `payload` | `string` | The value that was signed. |

These are the possible values for `reason` 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. |

<Note>
  External Documentation

  To learn more, visit the [GitHub documentation](https://docs.github.com/rest/commits/commits#list-commits).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter | Description |
  | - | - |
  | Author | GitHub login or email address by which to filter by commit author. |
  | End Time | Only commits before this date will be returned. |
  | Owner | The organization or person who owns the repository. github.com/{owner}/{repo} |
  | Page | Page number of the results to fetch. |
  | Path Contains | Only commits containing this file path will be returned. |
  | Per Page | The number of results per page (max 100). |
  | Repo | Name of the repository owned by the owner. github.com/{owner}/{repo} |
  | Return All Pages | Automatically fetch all resources, page by page. |
  | SHA Contains | SHA or branch to start listing commits from. Default: the repository’s default branch (usually `master`). |
  | Start Time | Only show notifications updated after the given time. |
</div>

## Example Output

```json theme={"dark"}
{
	"sha": "<string>",
	"node_id": "<string>",
	"commit": {
		"author": {
			"name": "<string>",
			"email": "<string>",
			"date": "2025-03-12T13:58:09Z"
		},
		"committer": {
			"name": "<string>",
			"email": "<string>",
			"date": "2025-03-12T13:58:09Z"
		},
		"message": "<string>",
		"tree": {
			"sha": "<string>",
			"url": "<string>"
		},
		"url": "<string>",
		"comment_count": 2,
		"verification": {
			"verified": true,
			"reason": "<string>",
			"signature": "<string>",
			"payload": "<string>",
			"verified_at": "2021-10-28T16:05:50Z"
		}
	},
	"url": "<string>",
	"html_url": "<string>",
	"comments_url": "<string>",
	"author": {
		"login": "<string>",
		"id": 9613673,
		"node_id": "<string>",
		"avatar_url": "<string>",
		"gravatar_id": "<string>",
		"url": "<string>",
		"html_url": "<string>",
		"followers_url": "<string>",
		"following_url": "<string>",
		"gists_url": "<string>",
		"starred_url": "<string>",
		"subscriptions_url": "<string>",
		"organizations_url": "<string>",
		"repos_url": "<string>",
		"events_url": "<string>",
		"received_events_url": "<string>",
		"type": "<string>",
		"user_view_type": "<string>",
		"site_admin": false
	},
	"committer": {
		"login": "<string>",
		"id": 18570210,
		"node_id": "<string>",
		"avatar_url": "<string>",
		"gravatar_id": "<string>",
		"url": "<string>",
		"html_url": "<string>",
		"followers_url": "<string>",
		"following_url": "<string>",
		"gists_url": "<string>",
		"starred_url": "<string>",
		"subscriptions_url": "<string>",
		"organizations_url": "<string>",
		"repos_url": "<string>",
		"events_url": "<string>",
		"received_events_url": "<string>",
		"type": "<string>",
		"user_view_type": "<string>",
		"site_admin": false
	},
	"parents": [
		{
			"sha": "<string>",
			"url": "<string>",
			"html_url": "<string>"
		}
	]
}
```

## Workflow Library Example

[List Commits with Github and Send Results Via Email](https://library.blinkops.com/workflows/list-commits-with-github-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-commits-with-github-and-send-results-via-email/canvas" />
</div>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.