Skip to main content
Get a list of repository branches from a project, sorted by name alphabetically.
External DocumentationTo learn more, visit the GitLab documentation.

​
Parameters

ParameterDescription
Project IDThe ID or path of the project owned by the authenticated user. If the path is being used, it should be url encoded - for example: user%2my-project .
SearchReturn list of branches containing the search string. You can use ^term and term$ to find branches that begin and end with term respectively.

​
Example Output

[
	{
		"name": "<string>",
		"commit": {
			"id": "<string>",
			"short_id": "<string>",
			"created_at": "2020-05-18T02:42:05",
			"parent_ids": [],
			"title": "<string>",
			"message": "<string>",
			"author_name": "<string>",
			"author_email": "<string>",
			"authored_date": "2022-11-09T05:50:43",
			"committer_name": "<string>",
			"committer_email": "<string>",
			"committed_date": "2021-11-24T13:02:39",
			"trailers": {},
			"extended_trailers": {},
			"web_url": "<string>"
		},
		"merged": false,
		"protected": true,
		"developers_can_push": false,
		"developers_can_merge": false,
		"can_push": true,
		"default": true,
		"web_url": "<string>"
	},
	{
		"name": "<string>",
		"commit": {
			"id": "<string>",
			"short_id": "<string>",
			"created_at": "2020-05-18T02:42:05",
			"parent_ids": [],
			"title": "<string>",
			"message": "<string>",
			"author_name": "<string>",
			"author_email": "<string>",
			"authored_date": "2020-05-18T02:42:05",
			"committer_name": "<string>",
			"committer_email": "<string>",
			"committed_date": "2020-05-18T02:42:05",
			"trailers": {},
			"extended_trailers": {},
			"web_url": "<string>"
		},
		"merged": false,
		"protected": false,
		"developers_can_push": false,
		"developers_can_merge": false,
		"can_push": true,
		"default": false,
		"web_url": "<string>"
	}
]

​
Workflow Library Example

List Branches with Gitlab and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop