# Get a job for a workflow run

From **GitHub v3 REST API**.

`GET /repos/{owner}/{repo}/actions/jobs/{job_id}`

Gets a specific job in a workflow run. 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.

## Parameters

### `owner`

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

### `repo`

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

### `job_id`

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

job_id parameter

## Responses

### `200`

Response

### `application/json`

- Type: `object`

Information of a job execution in a workflow run

```json
{
  "check_run_url": "https://api.github.com/repos/octo-org/octo-repo/check-runs/399444496",
  "completed_at": "2020-01-20T17:44:39Z",
  "conclusion": "success",
  "head_sha": "f83a356604ae3c5d03e1b46ef4d1ca77d64a90b0",
  "html_url": "https://github.com/octo-org/octo-repo/runs/399444496",
  "id": 399444496,
  "name": "build",
  "node_id": "MDEyOldvcmtmbG93IEpvYjM5OTQ0NDQ5Ng==",
  "run_id": 29679449,
  "run_url": "https://api.github.com/repos/octo-org/octo-repo/actions/runs/29679449",
  "started_at": "2020-01-20T17:42:40Z",
  "status": "completed",
  "steps": [
    {
      "completed_at": "2020-01-20T09:42:41.000-08:00",
      "conclusion": "success",
      "name": "Set up job",
      "number": 1,
      "started_at": "2020-01-20T09:42:40.000-08:00",
      "status": "completed"
    },
    {
      "completed_at": "2020-01-20T09:42:45.000-08:00",
      "conclusion": "success",
      "name": "Run actions/checkout@v2",
      "number": 2,
      "started_at": "2020-01-20T09:42:41.000-08:00",
      "status": "completed"
    },
    {
      "completed_at": "2020-01-20T09:42:45.000-08:00",
      "conclusion": "success",
      "name": "Set up Ruby",
      "number": 3,
      "started_at": "2020-01-20T09:42:45.000-08:00",
      "status": "completed"
    },
    {
      "completed_at": "2020-01-20T09:42:48.000-08:00",
      "conclusion": "success",
      "name": "Run actions/cache@v2",
      "number": 4,
      "started_at": "2020-01-20T09:42:45.000-08:00",
      "status": "completed"
    },
    {
      "completed_at": "2020-01-20T09:42:52.000-08:00",
      "conclusion": "success",
      "name": "Install Bundler",
      "number": 5,
      "started_at": "2020-01-20T09:42:48.000-08:00",
      "status": "completed"
    },
    {
      "completed_at": "2020-01-20T09:42:53.000-08:00",
      "conclusion": "success",
      "name": "Install Gems",
      "number": 6,
      "started_at": "2020-01-20T09:42:52.000-08:00",
      "status": "completed"
    },
    {
      "completed_at": "2020-01-20T09:42:59.000-08:00",
      "conclusion": "success",
      "name": "Run Tests",
      "number": 7,
      "started_at": "2020-01-20T09:42:53.000-08:00",
      "status": "completed"
    },
    {
      "completed_at": "2020-01-20T09:44:39.000-08:00",
      "conclusion": "success",
      "name": "Deploy to Heroku",
      "number": 8,
      "started_at": "2020-01-20T09:42:59.000-08:00",
      "status": "completed"
    },
    {
      "completed_at": "2020-01-20T09:44:39.000-08:00",
      "conclusion": "success",
      "name": "Post actions/cache@v2",
      "number": 16,
      "started_at": "2020-01-20T09:44:39.000-08:00",
      "status": "completed"
    },
    {
      "completed_at": "2020-01-20T09:44:39.000-08:00",
      "conclusion": "success",
      "name": "Complete job",
      "number": 17,
      "started_at": "2020-01-20T09:44:39.000-08:00",
      "status": "completed"
    }
  ],
  "url": "https://api.github.com/repos/octo-org/octo-repo/actions/jobs/399444496"
}
```

```json
{"description":"Information of a job execution in a workflow run","properties":{"check_run_url":{"example":"https://api.github.com/repos/github/hello-world/check-runs/4","type":"string"},"completed_at":{"description":"The time that the job finished, in ISO 8601 format.","example":"2019-08-08T08:00:00-07:00","format":"date-time","nullable":true,"type":"string"},"conclusion":{"description":"The outcome of the job.","example":"success","nullable":true,"type":"string"},"head_sha":{"description":"The SHA of the commit that is being run.","example":"009b8a3a9ccbb128af87f9b1c0f4c62e8a304f6d","type":"string"},"html_url":{"example":"https://github.com/github/hello-world/runs/4","nullable":true,"type":"string"},"id":{"description":"The id of the job.","example":21,"type":"integer"},"name":{"description":"The name of the job.","example":"test-coverage","type":"string"},"node_id":{"example":"MDg6Q2hlY2tSdW40","type":"string"},"run_attempt":{"description":"Attempt number of the associated workflow run, 1 for first attempt and higher if the workflow was re-run.","example":1,"type":"integer"},"run_id":{"description":"The id of the associated workflow run.","example":5,"type":"integer"},"run_url":{"example":"https://api.github.com/repos/github/hello-world/actions/runs/5","type":"string"},"started_at":{"description":"The time that the job started, in ISO 8601 format.","example":"2019-08-08T08:00:00-07:00","format":"date-time","type":"string"},"status":{"description":"The phase of the lifecycle that the job is currently in.","enum":["queued","in_progress","completed"],"example":"queued","type":"string"},"steps":{"description":"Steps in this job.","items":{"properties":{"completed_at":{"description":"The time that the job finished, in ISO 8601 format.","example":"2019-08-08T08:00:00-07:00","format":"date-time","nullable":true,"type":"string"},"conclusion":{"description":"The outcome of the job.","example":"success","nullable":true,"type":"string"},"name":{"description":"The name of the job.","example":"test-coverage","type":"string"},"number":{"example":1,"type":"integer"},"started_at":{"description":"The time that the step started, in ISO 8601 format.","example":"2019-08-08T08:00:00-07:00","format":"date-time","nullable":true,"type":"string"},"status":{"description":"The phase of the lifecycle that the job is currently in.","enum":["queued","in_progress","completed"],"example":"queued","type":"string"}},"required":["name","status","conclusion","number"],"type":"object"},"type":"array"},"url":{"example":"https://api.github.com/repos/github/hello-world/actions/jobs/21","type":"string"}},"required":["id","node_id","run_id","run_url","head_sha","name","url","html_url","status","conclusion","started_at","completed_at","check_run_url"],"title":"Job","type":"object"}
```

## Request examples

### cURL

```shell
curl --request GET \
  --url {protocol}://{hostname}/api/v3/repos/{owner}/{repo}/actions/jobs/{job_id}
```