Gets a list of project badges viewable by the authenticated user.

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://bump.sh/demo/doc/gitlab/mcp

Standard setup for AI tools providing an mcp.json file

      
          mcp.json

"Gitlab (Unofficial) MCP server": {
  "url": "https://bump.sh/demo/doc/gitlab/mcp"
}

GET /projects/{id}/badges

Api key auth

This feature was introduced in GitLab 10.6.

Path parameters

id string | integer Required

The ID or URL-encoded path of the project.

Query parameters

page integer(int32)

Current page number

Default value is 1.
per_page integer(int32)

Number of items per page

Default value is 20.
name string

Name for the badge

Responses

200 application/json

Gets a list of project badges viewable by the authenticated user.
Hide response attributes Show response attributes object
- name string
- link_url string
- image_url string
- rendered_link_url string
- rendered_image_url string
- id string
- kind string

GET /projects/{id}/badges

curl \
 --request GET 'https://www.gitlab.com/api/v4/projects/gitlab-org/gitlab/badges' \
 --header "Private-Token: $API_KEY"

Response examples (200)

[
  {
    "name": "string",
    "link_url": "string",
    "image_url": "string",
    "rendered_link_url": "string",
    "rendered_image_url": "string",
    "id": "string",
    "kind": "string"
  }
]