Get workflow run usage

GET

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

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. If the repository is private you must use an access token with the repo scope. GitHub Apps must have the actions:read permission to use this endpoint.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.github.com/repos///actions/runs//timing'

Response Example

{
    "billable": {
        "MACOS": {
            "job_runs": [
                {
                    "duration_ms": 0,
                    "job_id": 0
                }
            ],
            "jobs": 0,
            "total_ms": 0
        },
        "UBUNTU": {
            "job_runs": [
                {
                    "duration_ms": 0,
                    "job_id": 0
                }
            ],
            "jobs": 0,
            "total_ms": 0
        },
        "WINDOWS": {
            "job_runs": [
                {
                    "duration_ms": 0,
                    "job_id": 0
                }
            ],
            "jobs": 0,
            "total_ms": 0
        }
    },
    "run_duration_ms": 0
}

Request

Path Params

owner

string

required

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

repo

string

required

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

run_id

integer

required

The unique identifier of the workflow run.

Responses

🟢200Response

application/json

Body

Workflow Run Usage

billable

object

required

MACOS

object

optional

UBUNTU

object

optional

WINDOWS

object

optional

run_duration_ms

integer

optional

Modified at 2023-08-15 02:59:28

Re-run failed jobs from a workflow run

List repository secrets