---
title: "Return a particular job level by id on an effective date"
method: GET
path: "/v1/org/{orgId}/job-level/{jobLevelId}"
tags: ["job-level"]
---

# Return a particular job level by id on an effective date

`GET /v1/org/{orgId}/job-level/{jobLevelId}`

## Path parameters

- `orgId` string, required
- `jobLevelId` string, required

## Query parameters

- `date` string, date

## Response `200`

successful operation

- JobLevel
  - `id` string, required — globally unique id
  - `orgId` string, required — parent organization id
  - `label` string, required — human-readable name of job level
  - `code` string — job level code
  - `benchmarkType` EnumValue
    - `name` string, required — enum value name
    - `label` string, required — enum value label
    - `color` string — color of property
    - `expr` string — computed expression, for ENUM_EXPR type
    - `num` number — numeric value, for ENUM_SCALE type
    - `sort` integer — sort order
    - `rank` integer — rank order, if selected in rank order
    - `id` string — unique identifier for enum
    - `labelTr` Translations
      - `values` object, required
  - `benchmarkLevel` EnumValue
    - `name` string, required — enum value name
    - `label` string, required — enum value label
    - `color` string — color of property
    - `expr` string — computed expression, for ENUM_EXPR type
    - `num` number — numeric value, for ENUM_SCALE type
    - `sort` integer — sort order
    - `rank` integer — rank order, if selected in rank order
    - `id` string — unique identifier for enum
    - `labelTr` Translations
      - `values` object, required
  - `createId` string — created by user id
  - `createBehalfId` string — created on behalf of user id
  - `createAttribution` Attribution
    - `principalUserId` string
    - `agentUserIds` string[]
    - `eventId` string
    - `aiChatId` string
    - `aiToolUseId` string
    - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
  - `createAt` string — created timestamp
  - `updateId` string — last updated by user id
  - `updateBehalfId` string — last updated on behalf of user id
  - `updateAttribution` Attribution
    - `principalUserId` string
    - `agentUserIds` string[]
    - `eventId` string
    - `aiChatId` string
    - `aiToolUseId` string
    - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
  - `updateAt` string — last updated timestamp
  - `deleteId` string — deleted by user id
  - `deleteBehalfId` string — deleted on behalf of user id
  - `deleteAttribution` Attribution
    - `principalUserId` string
    - `agentUserIds` string[]
    - `eventId` string
    - `aiChatId` string
    - `aiToolUseId` string
    - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
  - `deleteAt` string — deleted timestamp

## Other responses

- `400` — bad request
- `401` — not authorized
- `404` — not found

---

[API](https://skmtc.net/charthop/apis/charthop-api.md) · [All operations](https://skmtc.net/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/charthop/charthop-api/revisions/2de21f45f447/schema)