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

Lists projects that are direct children of the specified folder or organization resource. `list()` provides a strongly consistent view of the projects underneath the specified parent resource. `list()` returns projects sorted based upon the (ascending) lexical ordering of their `display_name`. The caller must have `resourcemanager.projects.list` permission on the identified parent.

<Note>
  External Documentation

  To learn more, visit the [GCP documentation](https://docs.cloud.google.com/resource-manager/reference/rest/v3/projects/list).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                                                                                                                                                                                                                                        |
  | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Parent           | Required. The name of the parent resource whose projects are being listed. Only children of this parent resource are listed; descendants are not listed. If the parent is a folder, use the value `folders/{folder_id}`. If the parent is an organization, use the value `organizations/{org_id}`. |
  | Return All Pages | Automatically fetch all resources, page by page.                                                                                                                                                                                                                                                   |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter    | Description                                                                                                                                                                   |
  | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Page Size    | Optional. The maximum number of projects to return in the response. The server can return fewer projects than requested. If unspecified, server picks an appropriate default. |
  | Show Deleted | Optional. Indicate that projects in the `DELETE_REQUESTED` state should also be returned. Normally only `ACTIVE` projects are returned.                                       |
</div>

## Example Output

```json theme={"dark"}
{
	"nextPageToken": "Pagination token. If the result set is too large to fit in a single response, this token is returned. It encodes the position of the current result cursor. Feeding this value into a new list request with the `page_token` parameter gives the next page of the results. When `next_page_token` is not filled in, there is no next page and the list returned is the last page in the result set. Pagination tokens have a limited lifetime.",
	"projects": [
		{
			"createTime": "Output only. Creation time.",
			"deleteTime": "Output only. The time at which this resource was requested for deletion.",
			"displayName": "Optional. A user-assigned display name of the project. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My Project`",
			"etag": "Output only. A checksum computed by the server based on the current value of the Project resource. This may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.",
			"labels": {},
			"name": "Output only. The unique resource name of the project. It is an int64 generated number prefixed by \"projects/\". Example: `projects/415104041262`",
			"parent": "Optional. A reference to a parent Resource. eg., `organizations/123` or `folders/876`.",
			"projectId": "Immutable. The unique, user-assigned id of the project. It must be 6 to 30 lowercase ASCII letters, digits, or hyphens. It must start with a letter. Trailing hyphens are prohibited. Example: `tokyo-rain-123`",
			"state": "Output only. The project lifecycle state.",
			"updateTime": "Output only. The most recent time this resource was modified."
		}
	]
}
```

## Workflow Library Example

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