Source: https://www.puesto.dev/docs/api/jobs/get-a-job-by-id
Markdown source: https://www.puesto.dev/docs/api/jobs/get-a-job-by-id.md
Description: Retrieve a single job by its numeric id, including its company and resolved locations. Closed jobs remain retrievable.

# Get a job by id

`GET /api/v1/jobs/{id}`

Retrieve a single job by its numeric id, including its company and resolved locations. Closed jobs remain retrievable.

## Parameters

### Path parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | integer | Yes | The numeric job id. |

## Response

The requested job.

### Response fields

| Field | Type | Description |
| --- | --- | --- |
| `id` | integer | Numeric job id. |
| `source_id` | integer | Numeric source id. |
| `company_id` | integer | Numeric company id. |
| `external_job_id` | string | The job id assigned by the job's original source. |
| `url` | string | Canonical URL of the job listing. |
| `apply_url` | string \| null | Direct apply URL, or null. |
| `title` | string | Job title. |
| `location_raw` | string \| null | Raw location string from the source, or null. |
| `locations_raw` | JsonValue | — |
| `location` | string \| null | Human-readable location display string in the posting's original order; may lead with a region label while `country_code` reflects the primary country; or null. |
| `city` | string \| null | City, or null. |
| `region` | string \| null | Region / state, or null. |
| `postal_code` | string \| null | Postal code, or null. |
| `country_code` | string \| null | ISO 3166-1 alpha-2 country code, or null. |
| `latitude` | number \| null | Latitude, or null. |
| `longitude` | number \| null | Longitude, or null. |
| `usa` | boolean | Whether the job is located in the United States. |
| `country_codes` | string[] \| null | ISO 3166-1 alpha-2 country codes the job is tagged with, or null. |
| `admin1_refs` | string[] \| null | First-level administrative division refs, or null. |
| `workplace` | string \| null | Workplace arrangement (remote / hybrid / onsite), or null. |
| `employment_type` | string \| null | Employment type, or null. |
| `level` | string \| null | Seniority level, or null. |
| `language` | string \| null | ISO 639-1 language code, or null. |
| `salary_raw` | string \| null | Raw salary string from the source, or null. |
| `salary_min` | number \| null | Minimum of the stated salary range, or null. |
| `salary_max` | number \| null | Maximum of the stated salary range, or null. |
| `salary_currency` | string \| null | ISO 4217 salary currency code, or null. |
| `salary_period` | string \| null | Salary period (e.g. year, hour), or null. |
| `posted_at` | string \| null | When the job was posted as an ISO-8601 date-time string, or null. |
| `expires_at` | string \| null | When the job expires as an ISO-8601 date-time string, or null. |
| `content_hash` | string \| null | Content hash used for change detection, or null. |
| `first_seen_at` | string | When the job was first seen as an ISO-8601 date-time string. |
| `closed_at` | string \| null | When the job was delisted (null for open jobs) as an ISO-8601 date-time string, or null. |
| `created_at` | string | When the job record was created as an ISO-8601 date-time string. |
| `updated_at` | string | When the job record was last updated as an ISO-8601 date-time string. |
| `description_md` | string \| null | Markdown job description, or null. |
| `description_html` | string \| null | HTML job description, or null. |
| `company` | object \| null | Full company record, or null when unknown. |
| `locations` | object[] | Resolved locations associated with the job. |

## Authentication

Send your secret API key (prefixed `sk_`) as a bearer token in the `Authorization` header. See [Authentication](https://www.puesto.dev/docs/authentication.md).

## Errors

Errors use the RFC 7807 `application/problem+json` format. See [Errors](https://www.puesto.dev/docs/errors.md).

## Example request

```bash
curl -X GET "https://www.puesto.dev/api/v1/jobs/{id}" \
  -H "Authorization: Bearer sk_your_key_here"
```

Full spec: https://www.puesto.dev/api/v1/openapi.json