GIgitlab
runners
groups

List all runners in a group

Lists all runners available in a specified group and any ancestor groups, including any allowed instance runners.

get/api/v4/groups/{id}/runners

Request

  • Base URL
    https://gitlab.com
  • Auth
    none declared

Path parameters

idstring required

The ID of a group

Query parameters

type'instance_type' | 'group_type' | 'project_type'

The type of runners to return

pausedboolean

Whether to include only runners that are accepting or ignoring new jobs

status'active' | 'paused' | 'online' | 'offline' | 'never_contacted' | 'stale'

The status of runners to return

tag_liststring[]

A list of runner tags

version_prefixstring

The version prefix of runners to return

pageinteger

Current page number

per_pageinteger

Number of items per page

Response

List all runners in a group

idinteger required
descriptionstring required
ip_addressstring required
activeboolean required
pausedboolean required
is_sharedboolean required
runner_type'instance_type' | 'group_type' | 'project_type' required
namestring required
onlineboolean required
created_atstring date-time required
statusstring required
job_execution_status'active' | 'idle' required

Example response

{
  "id": 8,
  "description": "test-1-20150125",
  "ip_address": "127.0.0.1",
  "active": true,
  "is_shared": true,
  "runner_type": "instance_type",
  "name": "test",
  "online": true,
  "created_by": {
    "id": 1,
    "username": "admin",
    "public_email": "john@example.com",
    "name": "Administrator",
    "state": "active",
    "avatar_url": "https://gravatar.com/avatar/1",
    "avatar_path": "/user/avatar/28/The-Big-Lebowski-400-400.png",
    "custom_attributes": [
      {
        "key": "foo",
        "value": "bar"
      }
    ],
    "web_url": "https://gitlab.example.com/root"
  },
  "created_at": "2025-05-03T00:00:00.000Z",
  "status": "online",
  "job_execution_status": "idle"
}

Changes

No recorded changes to this operation across all 5 revisions of this API.