---
title: "Retrieve details on a runner"
method: GET
path: "/api/v4/runners/{id}"
tags: ["runners"]
---

# Retrieve details on a runner

`GET /api/v4/runners/{id}`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/runners/{id}`
- Auth: none declared

Retrieves details of a runner. Instance runner details are available to all authenticated users through this endpoint. For groups and projects, you must have the Maintainer or Owner role for the associated project or group.

## Path parameters

- `id` integer, required

## Query parameters

- `include_projects` boolean

## Response `200`

Retrieve details on a runner

- APIEntitiesCiRunnerDetails: API_Entities_Ci_RunnerDetails model
  - `id` integer, required
  - `description` string, required
  - `ip_address` string, required
  - `active` boolean, required
  - `paused` boolean, required
  - `is_shared` boolean, required
  - `runner_type` 'instance_type' | 'group_type' | 'project_type', required
  - `name` string, required
  - `online` boolean, required
  - `created_by` APIEntitiesUserBasic: API_Entities_UserBasic model
    - `id` integer, required
    - `username` string, required
    - `public_email` string, required
    - `name` string, required
    - `state` string, required
    - `locked` boolean, required
    - `avatar_url` string, required
    - `avatar_path` string
    - `custom_attributes` APIEntitiesCustomAttribute[]
      - `key` string, required
      - `value` string, required
    - `web_url` string, required
  - `created_at` string, date-time, required
  - `status` string, required
  - `job_execution_status` 'active' | 'idle', required
  - `tag_list` string, required
  - `run_untagged` string, required
  - `locked` string, required
  - `maximum_timeout` string, required
  - `access_level` string, required
  - `version` string, required
  - `revision` string, required
  - `platform` string, required
  - `architecture` string, required
  - `contacted_at` string, required
  - `maintenance_note` string, required
  - `projects` APIEntitiesBasicProjectDetails: API_Entities_BasicProjectDetails model
    - `id` integer, required
    - `description` string, required
    - `name` string, required
    - `name_with_namespace` string, required
    - `path` string, required
    - `path_with_namespace` string, required
    - `created_at` string, date-time, required
    - `default_branch` string
    - `tag_list` string[], required
    - `topics` string[], required
    - `ssh_url_to_repo` string, required
    - `http_url_to_repo` string, required
    - `web_url` string, required
    - `readme_url` string
    - `forks_count` integer
    - `license_url` string
    - `license` APIEntitiesLicenseBasic
      - `key` string, required
      - `name` string, required
      - `nickname` string, required
      - `html_url` string, required
      - `source_url` string, required
    - `avatar_url` string, required
    - `star_count` integer, required
    - `last_activity_at` string, date-time, required
    - `visibility` string, required
    - `namespace` APIEntitiesNamespaceBasic, required
      - `id` integer, required
      - `name` string, required
      - `path` string, required
      - `kind` string, required
      - `full_path` string, required
      - `parent_id` integer, required
      - `avatar_url` string, required
      - `web_url` string, required
    - `custom_attributes` APIEntitiesCustomAttribute: API_Entities_CustomAttribute model
      - `key` string, required
      - `value` string, required
    - `repository_storage` string
  - `groups` APIEntitiesBasicGroupDetails, required: API_Entities_BasicGroupDetails model
    - `id` integer, required
    - `web_url` string, required
    - `name` string, required

## Other responses

- `401`: Unauthorized
- `403`: No access granted
- `404`: Runner not found

---

[API](https://skmtc.dev/gitlab/apis/gitlab-api.md) - [All operations](https://skmtc.dev/gitlab/apis/gitlab-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitlab/apis/gitlab-api/revisions/b234947ef3f2?raw)