---
title: "GET /postings/{postingId}"
method: GET
path: "/postings/{postingId}"
tags: ["Postings"]
---

# GET /postings/{postingId}

`GET /postings/{postingId}`

## Request

- Base URL: `https://api.lightcast.io/jpa`
- URL: `https://api.lightcast.io/jpa/postings/{postingId}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.emsicloud.com/connect/token` scopes: `postings:us`

Get a single posting by its id.

## Path parameters

- `postingId` string, required

## Query parameters

- `soc_version` 'soc_2021' | 'soc_emsi_2019'
- `onet_version` 'onet_2019' | 'onet_2010'
- `title_version` 'emsi'
- `company_version` 'emsi_company'
- `naics_version` 'naics_std_2022'
- `new_taxonomy_versions` true | false
- `soc_lightcast_version` '2010.2019.0' | '2018.2021.0'
- `onet_standard_version` '2019.0.0' | '2010.0.0'
- `lot_version` '6' | '7'

## Response `200`

OK

- object
  - `data` object, required
    - `active_urls` string[]
    - `active_sources_info` object[], nullable
      - `source` string
      - `type` string
      - `url` string
    - `body` string
    - `city` string
    - `city_name` string
    - `company` string, nullable
    - `company_name` string, nullable
    - `company_raw` string, nullable
    - `company_is_staffing` boolean, nullable
    - `contract_type` integer
    - `contract_type_name` string
    - `county` integer
    - `county_name` string
    - `duplicates` number
    - `duration` number, nullable
    - `edulevels` union[]
      - union
        - integer
        - string
    - `edulevels_name` string[]
    - `employment_type` integer, nullable
    - `employment_type_name` string, nullable
    - `expired` string, nullable
    - `id` string
    - `is_internship` boolean
    - `is_supervisor` boolean
    - `location` object, nullable
      - `lat` number, required
      - `lon` number, required
    - `max_years_experience` integer, nullable
    - `min_years_experience` integer, nullable
    - `msa` integer, nullable
    - `msa_name` string, nullable
    - `naics2` string, nullable
    - `naics2_name` string, nullable
    - `naics3` string, nullable
    - `naics3_name` string, nullable
    - `naics4` string, nullable
    - `naics4_name` string, nullable
    - `naics5` string, nullable
    - `naics5_name` string, nullable
    - `naics6` string, nullable
    - `naics6_name` string, nullable
    - `onet` string, nullable
    - `onet_name` string, nullable
    - `posted` string
    - `salary` integer, nullable
    - `min_salary` integer, nullable
    - `max_salary` integer, nullable
    - `score` number
    - `skills` string[]
    - `skills_name` string[]
    - `cip2` string[]
    - `cip2_name` string[]
    - `cip4` string[]
    - `cip4_name` string[]
    - `cip6` string[]
    - `cip6_name` string[]
    - `soc2` string
    - `soc2_name` string
    - `soc3` string
    - `soc3_name` string
    - `soc4` string
    - `soc4_name` string
    - `soc5` string
    - `soc5_name` string
    - `sources` string[]
    - `source_types` string[]
    - `state` integer
    - `state_name` string
    - `title` string
    - `title_name` string
    - `title_raw` string, nullable
    - `url` string[]
    - `remote_type` integer, nullable
    - `remote_type_name` string, nullable
    - `occupation` string, nullable
    - `occupation_name` string, nullable
    - `occupation_group` string, nullable
    - `occupation_group_name` string, nullable
    - `specialized_occupation` string, nullable
    - `specialized_occupation_name` string, nullable
    - `career_area` string, nullable
    - `career_area_name` string, nullable
    - `lot_occupation` string, nullable
    - `lot_occupation_name` string, nullable
    - `lot_occupation_group` string, nullable
    - `lot_occupation_group_name` string, nullable
    - `lot_specialized_occupation` string, nullable
    - `lot_specialized_occupation_name` string, nullable
    - `lot_career_area` string, nullable
    - `lot_career_area_name` string, nullable
    - `skill_categories` string[]
    - `skill_categories_name` string[]
    - `skill_subcategories` string[]
    - `skill_subcategories_name` string[]
    - `is_hwol` boolean
    - `is_fortune100` boolean
    - `is_fortune1000` boolean
    - `is_fortune500` boolean
    - `employee_count_range` string, nullable
    - `revenue_bucket` string, nullable
    - `min_edulevels` integer, nullable
    - `min_edulevels_name` string, nullable
    - `max_edulevels` integer, nullable
    - `max_edulevels_name` string, nullable
    - `job_seniority` string, nullable
    - `job_seniority_name` string, nullable

## Other responses

- `400`: Your request wasn't valid (bad parameter names or values).
- `401`: Your request wasn't unauthorized.
- `404`: The facet you requested wasn't found.

---

[API](https://skmtc.dev/lightcast/apis/job-postings-us.md) - [All operations](https://skmtc.dev/lightcast/apis/job-postings-us/llms.txt) - [OpenAPI document](https://skmtc.dev/lightcast/apis/job-postings-us/revisions/0394acf115db?raw)