---
title: "Get a specific company list by name."
method: GET
path: "/company/named-lists/{listName}"
tags: ["Metadata"]
---

# Get a specific company list by name.

`GET /company/named-lists/{listName}`

## Path parameters

- `listName` string, required

## Query parameters

- `includeArchived` boolean

## Response `200`

Successful response. Please note that the item ID may be textual or numeric depending on the list type.

- List
  - `name` string — The name of the list
  - `items` ListItem[] — The elements in the list.
    - `id` integer — Internal ID of the item.
    - `value` string — Value of the item.
    - `name` string — Name of the item.
    - `archived` boolean — Whether the item is archived (not available for selection).
    - `children` NestedListItem[] — Nested items - if the list is nested.
      - `id` integer
      - `value` string
      - `name` string
      - `archived` boolean
      - `children` object[]
        - `id` integer
        - `value` string
        - `name` string
        - `archived` boolean

## Other responses

- `404` — If the list was not found.

---

[API](https://skmtc.net/hibob/apis/employee-data-api.md) · [All operations](https://skmtc.net/hibob/apis/employee-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hibob/employee-data-api/versions/0781ebbdda91/schema)