> ## 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 By Group ID

Return a list of GitLab projects by a group ID.

**Note:** When executed without a connection, only public projects are returned.

<Note>
  External Documentation

  To learn more, visit the [GitLab documentation](https://docs.gitlab.com/api/groups/#list-projects).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                                                                                                                                                                                                                                                        |
  | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | Group ID         | The ID or URL-encoded path of the group owned by the authenticated user. Can be obtained via the `List Groups` action.<br /><br />For more information refer to [GitLab documentation](https://docs.gitlab.com/api/rest/#namespaced-paths).                                                                        |
  | Order By         | Select the field to order the results by.<br /><br />**Note:** <br />\* When set to `similarity`, the `Sort` parameter is ignored, and the `Search` parameter must be provided.<br />\* When the `Search` parameter is not provided, results are ordered by `name`.                                                |
  | Page             | The page number to get results from. The value must be greater than `0`.<br /><br />**Note:** There is a maximum allowed offset, for more information refer to the [GitLab Documentation](https://docs.gitlab.com/administration/instance_limits/#max-offset-allowed-by-the-rest-api-for-offset-based-pagination). |
  | Per Page         | The maximum number of results to return.<br /><br />**Note:** There is a maximum allowed offset, for more information refer to the [GitLab Documentation](https://docs.gitlab.com/administration/instance_limits/#max-offset-allowed-by-the-rest-api-for-offset-based-pagination).                                 |
  | Return All Pages | Automatically fetch all resources, page by page.                                                                                                                                                                                                                                                                   |
  | Search           | The search value to filter the list of authorized projects by.<br /><br />**Note:** If the `Search` parameter is not provided, results are ordered by `name`.                                                                                                                                                      |
  | Sort             | Select the order in which results are returned. Use `asc` for ascending order and `desc` for descending order.<br /><br />**Note:** This parameter is ignored if `Order By` parameter is set to `similarity`.                                                                                                      |
  | Visibility       | Select the visibility level of the projects to filter results by.                                                                                                                                                                                                                                                  |
</div>

## Example Output

```json theme={"dark"}
[
	{
		"id": 9,
		"description": "foo",
		"default_branch": "main",
		"tag_list": [],
		"topics": [],
		"archived": false,
		"visibility": "internal",
		"ssh_url_to_repo": "git@gitlab.example.com/html5-boilerplate.git",
		"http_url_to_repo": "http://gitlab.example.com/h5bp/html5-boilerplate.git",
		"web_url": "http://gitlab.example.com/h5bp/html5-boilerplate",
		"name": "Html5 Boilerplate",
		"name_with_namespace": "Experimental / Html5 Boilerplate",
		"path": "html5-boilerplate",
		"path_with_namespace": "h5bp/html5-boilerplate",
		"issues_enabled": true,
		"merge_requests_enabled": true,
		"wiki_enabled": true,
		"jobs_enabled": true,
		"snippets_enabled": true,
		"created_at": "2016-04-05T21:40:50.169Z",
		"last_activity_at": "2016-04-06T16:52:08.432Z",
		"shared_runners_enabled": true,
		"creator_id": 1,
		"namespace": {
			"id": 5,
			"name": "Experimental",
			"path": "h5bp",
			"kind": "group"
		},
		"avatar_url": null,
		"star_count": 1,
		"forks_count": 0,
		"open_issues_count": 3,
		"public_jobs": true,
		"shared_with_groups": [],
		"request_access_enabled": false
	}
]
```

## Workflow Library Example

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