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

Retrieve a list of projects.

**Required Permission**:

* `cyera.view.projects`

<Note>
  External Documentation

  To learn more, visit the [Cyera documentation](https://api.cyera.io/docs#tag/projects/get/v1/projects).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                        |
  | ---------------- | ---------------------------------------------------------------------------------- |
  | Limit            | The maximum number of user tags to retrieve in the result. Valid range is `1-100`. |
  | Offset           | The pagination offset indicating the starting point for the next set of results.   |
  | Project Name     | A project name to filter the results by.                                           |
  | Return All Pages | Automatically fetch all resources, page by page.                                   |
</div>

## Example Output

```json theme={"dark"}
{
	"limit": 10,
	"offset": 0,
	"results": [
		{
			"createdAt": "Project creation date",
			"datastoresCount": 0,
			"description": "Project description",
			"id": "753c0095-7a62-48ef-9e3c-1ddcc2261395",
			"name": "Project Name",
			"projectScope": {
				"combinationsRelation": "string",
				"filters": [
					{
						"accountUids": {
							"field": "string",
							"operator": "string",
							"values": [
								"3b4d83a8-1fe3-498d-b3d6-8cb15feceabc"
							]
						},
						"cloudProviderTags": {
							"field": "string",
							"operator": "string",
							"values": [
								"string"
							]
						},
						"datastoreDbmsValues": {
							"field": "string",
							"operator": "string",
							"values": [
								"string"
							]
						},
						"datastoreOwnerCountries": {
							"field": "string",
							"operator": "string",
							"values": [
								"string"
							]
						},
						"datastoreOwnerDepartments": {
							"field": "string",
							"operator": "string",
							"values": [
								"string"
							]
						},
						"datastoreOwnerEmails": {
							"field": "string",
							"operator": "string",
							"values": [
								"string"
							]
						},
						"datastoreOwnerJobTitles": {
							"field": "string",
							"operator": "string",
							"values": [
								"string"
							]
						},
						"datastoreOwnerOfficeLocations": {
							"field": "string",
							"operator": "string",
							"values": [
								"string"
							]
						},
						"datastoreUids": {
							"field": "string",
							"operator": "string",
							"values": [
								"3b4d83a8-1fe3-498d-b3d6-8cb15feceabc"
							]
						},
						"infrastructures": {
							"field": "string",
							"operator": "string",
							"values": [
								"string"
							]
						},
						"regions": {
							"field": "string",
							"operator": "string",
							"values": [
								"string"
							]
						},
						"userTagUids": {
							"field": "string",
							"operator": "string",
							"values": [
								"string"
							]
						}
					}
				]
			},
			"ssoGroups": [
				"string"
			],
			"updatedAt": "Project last updated date",
			"users": [
				{
					"email": "Project Name",
					"id": "753c0095-7a62-48ef-9e3c-1ddcc2261395",
					"name": "Project Name",
					"profilePictureUrl": "Project Name"
				}
			]
		}
	],
	"total": 1
}
```

## Workflow Library Example

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