Skip to content
forgit api docs

Get workflow run usage

GET
/repos/{owner}/{repo}/actions/runs/{run_id}/timing

[!WARNING]
This endpoint is in the process of closing down. Refer to “Actions Get workflow usage and Get workflow run usage endpoints closing down” for more information.

Gets the number of billable minutes and total run time for a specific workflow run. Billable minutes only apply to workflows in private repositories that use GitHub-hosted runners. Usage is listed for each GitHub-hosted runner operating system in milliseconds. Any job re-runs are also included in the usage. The usage does not include the multiplier for macOS and Windows runners and is not rounded up to the nearest whole minute. For more information, see “Managing billing for GitHub Actions”.

Anyone with read access to the repository can use this endpoint.

OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint with a private repository.

API method documentation

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “ Path Parameters ”
owner
required
string

The account owner of the repository. The name is not case sensitive.

repo
required
string

The name of the repository without the .git extension. The name is not case sensitive.

run_id
required
integer

The unique identifier of the workflow run.

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

Response

Media type application/json
Workflow Run Usage

Workflow Run Usage

object
billable
required
object
UBUNTU
object
total_ms
required
integer
jobs
required
integer
job_runs
Array<object>
object
job_id
required
integer
duration_ms
required
integer
MACOS
object
total_ms
required
integer
jobs
required
integer
job_runs
Array<object>
object
job_id
required
integer
duration_ms
required
integer
WINDOWS
object
total_ms
required
integer
jobs
required
integer
job_runs
Array<object>
object
job_id
required
integer
duration_ms
required
integer
run_duration_ms
integer
Examples
Example default 
{
  "billable": {
    "UBUNTU": {
      "total_ms": 180000,
      "jobs": 1,
      "job_runs": [
        {
          "job_id": 1,
          "duration_ms": 180000
        }
      ]
    },
    "MACOS": {
      "total_ms": 240000,
      "jobs": 4,
      "job_runs": [
        {
          "job_id": 2,
          "duration_ms": 60000
        },
        {
          "job_id": 3,
          "duration_ms": 60000
        },
        {
          "job_id": 4,
          "duration_ms": 60000
        },
        {
          "job_id": 5,
          "duration_ms": 60000
        }
      ]
    },
    "WINDOWS": {
      "total_ms": 300000,
      "jobs": 2,
      "job_runs": [
        {
          "job_id": 6,
          "duration_ms": 150000
        },
        {
          "job_id": 7,
          "duration_ms": 150000
        }
      ]
    }
  },
  "run_duration_ms": 500000
}