---
title: "Read metadata of custom tables defined"
method: GET
path: "/people/custom-tables/metadata"
tags: ["Custom Tables"]
---

# Read metadata of custom tables defined

`GET /people/custom-tables/metadata`

## Response `200`

Successful response

- CustomTableMetadataList
  - `tables` CustomTableMetadata[]
    - `id` string — The identifier of custom table
    - `category` string — The ID of the category to which the custom table belongs
    - `name` string — The name of custom table
    - `description` string — The description of custom table
    - `columns` CustomTableColumn[]
      - `id` string — The ID of the column
      - `name` string — The name of the column
      - `description` string — The description of the column
      - `mandatory` boolean — Flag which means that column must be present during creation and its value can't be null during update
      - `type` string — The type of the column. Supported column types: text, text-area, number, date, list, multi-list, hierarchy-list, currency, employee-reference, document.
      - `typeData` object
        - `listId` string — The ID of the list in the /v1/company/named-lists endpoint.

---

[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/revisions/0781ebbdda91/schema)