v56

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-011,21696712.2 MB
actions

List GitHub-hosted runners in a group for an organization

Lists the GitHub-hosted runners in an organization group.

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

get/orgs/{org}/actions/runner-groups/{runner_group_id}/hosted-runners

Path parameters

orgstring required

The organization name. The name is not case sensitive.

runner_group_idinteger required

Unique identifier of the self-hosted runner group.

Query parameters

per_pageinteger

The number of results per page (max 100). For more information, see "Using pagination in the REST API."

pageinteger

The page number of the results to fetch. For more information, see "Using pagination in the REST API."

Response

Response

total_countnumber required

Example response

{
  "runners": [
    {
      "id": 5,
      "name": "my-github-hosted-runner",
      "runner_group_id": 2,
      "image_details": {
        "id": "ubuntu-20.04",
        "size_gb": 86,
        "version": "latest"
      },
      "machine_size_details": {
        "id": "8-core",
        "cpu_cores": 8,
        "memory_gb": 32,
        "storage_gb": 300
      },
      "status": "Ready",
      "platform": "linux-x64",
      "maximum_runners": 5,
      "public_ip_enabled": true,
      "public_ips": [
        {
          "enabled": true,
          "prefix": "20.80.208.150",
          "length": 28
        }
      ],
      "last_active_on": "2022-10-09T23:39:01Z"
    }
  ]
}