# Jobs (/sdk/reference/jobs)



{/* Generated by docs-site/scripts/generate-sdk-docs.ts — do not edit. */}

### `getJob` [#getjob]

`GET /api/v0/organizations/{org}/pipelines/{pipeline}/builds/{number}/jobs/{job_id}`

Get a job

Returns a single job within the build. A `job_id` that belongs to another build is reported as 404.

```ts
import { getJob } from "@harmont/cloud";
```

```ts
getJob(options): RequestResult<GetJobResponse>
```

| Parameter  | In   | Type     | Description            |
| ---------- | ---- | -------- | ---------------------- |
| `org`      | path | `string` | The organization slug. |
| `pipeline` | path | `string` | The pipeline slug.     |
| `number`   | path | `number` | The build number.      |
| `job_id`   | path | `string` | The job id.            |

**Returns** `GetJobResponse`

See [`GET /api/v0/organizations/{org}/pipelines/{pipeline}/builds/{number}/jobs/{job_id}`](/api/reference/jobs) for the full request and response schema.

### `listJobs` [#listjobs]

`GET /api/v0/organizations/{org}/pipelines/{pipeline}/builds/{number}/jobs`

List a build's jobs

Returns the build's jobs in DAG creation order.

```ts
import { listJobs } from "@harmont/cloud";
```

```ts
listJobs(options): RequestResult<ListJobsResponse>
```

| Parameter  | In   | Type     | Description            |
| ---------- | ---- | -------- | ---------------------- |
| `org`      | path | `string` | The organization slug. |
| `pipeline` | path | `string` | The pipeline slug.     |
| `number`   | path | `number` | The build number.      |

**Returns** `ListJobsResponse`

See [`GET /api/v0/organizations/{org}/pipelines/{pipeline}/builds/{number}/jobs`](/api/reference/jobs) for the full request and response schema.