> ## 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 Projects

Returns a list of projects visible to the user.

This operation can be accessed anonymously.

**Permissions required:** Projects are returned only where the user has one of:

* *Browse Projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project.
* *Administer Projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project.
* *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

<Note>
  External Documentation

  To learn more, visit the [Jira documentation](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-projects/#api-rest-api-3-project-search-get).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter | Description                                                               |
  | --------- | ------------------------------------------------------------------------- |
  | Limit     | The maximum number of items to return per page.                           |
  | Offset    | The index of the first item to return in a page of results (page offset). |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter | Description                                                                                                          |
  | --------- | -------------------------------------------------------------------------------------------------------------------- |
  | Query     | Filter the results using a literal string. Projects with a matching `key` or `name` are returned (case insensitive). |
</div>

## Example Output

```json theme={"dark"}
{
	"isLast": false,
	"maxResults": 2,
	"nextPage": "https://your-domain.atlassian.net/rest/api/3/project/search?startAt=2\u0026maxResults=2",
	"self": "https://your-domain.atlassian.net/rest/api/3/project/search?startAt=0\u0026maxResults=2",
	"startAt": 0,
	"total": 7,
	"values": [
		{
			"avatarUrls": {
				"16x16": "https://your-domain.atlassian.net/secure/projectavatar?size=xsmall\u0026pid=10000",
				"24x24": "https://your-domain.atlassian.net/secure/projectavatar?size=small\u0026pid=10000",
				"32x32": "https://your-domain.atlassian.net/secure/projectavatar?size=medium\u0026pid=10000",
				"48x48": "https://your-domain.atlassian.net/secure/projectavatar?size=large\u0026pid=10000"
			},
			"id": "10000",
			"insight": {
				"lastIssueUpdateTime": "2021-08-19T05:11:51.747+0000",
				"totalIssueCount": 100
			},
			"key": "EX",
			"name": "Example",
			"projectCategory": {
				"description": "First Project Category",
				"id": "10000",
				"name": "FIRST",
				"self": "https://your-domain.atlassian.net/rest/api/3/projectCategory/10000"
			},
			"self": "https://your-domain.atlassian.net/rest/api/3/project/EX",
			"simplified": false,
			"style": "classic"
		},
		{
			"avatarUrls": {
				"16x16": "https://your-domain.atlassian.net/secure/projectavatar?size=xsmall\u0026pid=10001",
				"24x24": "https://your-domain.atlassian.net/secure/projectavatar?size=small\u0026pid=10001",
				"32x32": "https://your-domain.atlassian.net/secure/projectavatar?size=medium\u0026pid=10001",
				"48x48": "https://your-domain.atlassian.net/secure/projectavatar?size=large\u0026pid=10001"
			},
			"id": "10001",
			"insight": {
				"lastIssueUpdateTime": "2021-08-19T05:11:51.747+0000",
				"totalIssueCount": 100
			},
			"key": "ABC",
			"name": "Alphabetical",
			"projectCategory": {
				"description": "First Project Category",
				"id": "10000",
				"name": "FIRST",
				"self": "https://your-domain.atlassian.net/rest/api/3/projectCategory/10000"
			},
			"self": "https://your-domain.atlassian.net/rest/api/3/project/ABC",
			"simplified": false,
			"style": "classic"
		}
	]
}
```

## Workflow Library Example

[List Projects with Jira and Send Results Via Email](https://library.blinkops.com/workflows/list-projects-with-jira-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-projects-with-jira-and-send-results-via-email/canvas" />
</div>