---
title: "Get mapping table"
method: GET
path: "/v1/mapping-tables/{table-id}"
tags: ["Mapping Tables"]
---

# Get mapping table

`GET /v1/mapping-tables/{table-id}`

Retrieve mapping table with all its elements. Mapping table content is needed for displaying
DCI values, so no system access right is required.

## Response `200`

Mapping table details.

- MappingTable
  - `id` integer — Mapping table ID.
  - `guid` string, uuid — Mapping table GUID.
  - `name` string — Mapping table name.
  - `description` string — Mapping table description.
  - `flags` integer — Mapping table flags (bit 0 - numeric keys).
  - `elements` MappingTableElement[]
    - `key` string, required — Element key. For tables with numeric keys flag set, key is parsed as integer (decimal, or hexadecimal with `0x` prefix) and stored in decimal form.
    - `value` string — Mapped value.
    - `description` string — Element description.

## Other responses

- `400` — Invalid table ID.
- `401` — Unauthorized.
- `404` — Mapping table not found.

## Changes

- **2026-09-30** `d3ebef46a35c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/mapping-tables/:table-id/get.md)

---

[API](https://skmtc.dev/netxms/apis/netxms-api.md) · [All operations](https://skmtc.dev/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/netxms/apis/netxms-api/revisions/129789f8868f?raw)