---
title: "Get diversity benchmark data"
method: POST
path: "/diversity"
tags: ["Diversity"]
---

# Get diversity benchmark data

`POST /diversity`

## Request

- Base URL: `https://api.lightcast.io/benchmark`
- URL: `https://api.lightcast.io/benchmark/diversity`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.emsicloud.com/connect/token` scopes: `benchmark`

Lightcast models diversity data by applying a staffing pattern to government data related to industries. Diversity is defined through white and non-white, gender, and age demographics.

Advanced filtering is available for this endpoint. For more details, take a look at [Advanced Filtering](#advanced-filtering) section of this documentation.

## Request body

- Schema (unresolved $ref)

## Response `200`

OK

- object
  - `searchParams` object, required
    - `area` union, required: This field will return a list of area objects if `advanced` filter was used. Otherwise, it will be an area object.
      - object
        - `id` string, required
        - `name` string, required
        - `level` string, required
      - object[]
        - `id` string, required
        - `name` string, required
        - `level` string, required
    - `title` object, nullable, required
      - `id` string, nullable, required
      - `name` string, nullable, required
    - `occupations` object[], required
      - `id` string, required
      - `name` string, required
    - `skills` object[], required
      - `id` string, required
      - `name` string, required
  - `data` object, required
    - `summary` object, required
      - `regional` number, required
      - `regionalPct` number, required
      - `national` number, required
      - `nationalPct` number, required
    - `age` object[], required
      - `id` number, required
      - `name` string, required
      - `regional` number, required
      - `regionalPct` number, required
      - `national` number, required
      - `nationalPct` number, required
    - `demographics` object[], required
      - `id` number, required
      - `name` string, required
      - `regional` number, required
      - `regionalPct` number, required
      - `national` number, required
      - `nationalPct` number, required
    - `gender` object[], required
      - `id` number, required
      - `name` string, required
      - `regional` number, required
      - `regionalPct` number, required
      - `national` number, required
      - `nationalPct` number, required

## Other responses

- `400`: Your request wasn't valid (bad parameter names or values).
- `401`: You don't have access to the endpoint.
- `404`: The facet you requested wasn't found.

---

[API](https://skmtc.dev/lightcast/apis/talent-benchmark.md) - [All operations](https://skmtc.dev/lightcast/apis/talent-benchmark/llms.txt) - [OpenAPI document](https://skmtc.dev/lightcast/apis/talent-benchmark/revisions/45f810840bb1?raw)