# Get a self-hosted runner for an enterprise

From **GitHub v3 REST API**.

`GET /enterprises/{enterprise}/actions/runners/{runner_id}`

Gets a specific self-hosted runner configured in an enterprise.

You must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.

## Parameters

### `enterprise`

- Location: path
- Required: true
- Type: `string`

The slug version of the enterprise name. You can also substitute this value with the enterprise id.

### `runner_id`

- Location: path
- Required: true
- Type: `integer`

Unique identifier of the self-hosted runner.

## Responses

### `200`

Response

### `application/json`

- Type: `object`

A self hosted runner

```json
{
  "busy": true,
  "id": 23,
  "labels": [
    {
      "id": 5,
      "name": "self-hosted",
      "type": "read-only"
    },
    {
      "id": 7,
      "name": "X64",
      "type": "read-only"
    },
    {
      "id": 20,
      "name": "macOS",
      "type": "read-only"
    },
    {
      "id": 21,
      "name": "no-gpu",
      "type": "custom"
    }
  ],
  "name": "MBP",
  "os": "macos",
  "status": "online"
}
```

```json
{"description":"A self hosted runner","properties":{"busy":{"type":"boolean"},"id":{"description":"The id of the runner.","example":5,"type":"integer"},"labels":{"items":{"$ref":"#/components/schemas/runner-label"},"type":"array"},"name":{"description":"The name of the runner.","example":"iMac","type":"string"},"os":{"description":"The Operating System of the runner.","example":"macos","type":"string"},"status":{"description":"The status of the runner.","example":"online","type":"string"}},"required":["id","name","os","status","busy","labels"],"title":"Self hosted runners","type":"object"}
```

## Request examples

### cURL

```shell
curl --request GET \
  --url {protocol}://{hostname}/api/v3/enterprises/{enterprise}/actions/runners/{runner_id}
```