---
title: "Get a lookup table."
method: GET
path: "/v1/lookupTables/{id}"
tags: ["lookupManagement"]
---

# Get a lookup table.

`GET /v1/lookupTables/{id}`

Get a lookup table for the given identifier.

## Path parameters

- `id` string, required

## Response `200`

Definition of the lookup table.

- LookupTable — The lookup table definition independent of its location in the Library and name.
  - `createdAt` string, date-time, required — Creation timestamp in UTC in [RFC3339](https://tools.ietf.org/html/rfc3339) format.
  - `createdBy` string, required — Identifier of the user who created the resource.
  - `modifiedAt` string, date-time, required — Last modification timestamp in UTC.
  - `modifiedBy` string, required — Identifier of the user who last modified the resource.
  - `description` string, required — The description of the lookup table.
  - `fields` LookupTableField[], required — The list of fields in the lookup table.
    - `fieldName` string, required — The name of the field.
    - `fieldType` string, required — The data type of the field. Supported types: - `boolean` - `int` - `long` - `double` - `string`
  - `primaryKeys` string[], required — The names of the fields that make up the primary key for the lookup table. These will be a subset of the fields that the table will contain.
  - `ttl` integer — A time to live for each entry in the lookup table (in minutes). 365 days is the maximum time to live for each entry that you can specify. Setting it to 0 means that the records will not expire automatically.
  - `sizeLimitAction` string — The action that needs to be taken when the size limit is reached for the table. The possible values can be `StopIncomingMessages` or `DeleteOldData`. DeleteOldData will start deleting old data once size limit is reached whereas StopIncomingMessages will discard all the updates made to the lookup table once size limit is reached.
  - `name` string, required — The name of the lookup table.
  - `parentFolderId` string, required — The parent-folder-path identifier of the lookup table in the Library.
  - `id` string, required — Identifier of the lookup table as a content item.
  - `contentPath` string — Address/path of the parent folder of this lookup table in content library. For example, a lookup table existing in the personal/lookupTable folder for user johndoe would be: /Library/Users/johndoe@acme.com/lookupTable
  - `size` integer — The current size of the lookup table in bytes

## Other responses

- `default` — Operation failed with an error.

---

[API](https://skmtc.net/sumologic/apis/sumo-logic-api.md) · [All operations](https://skmtc.net/sumologic/apis/sumo-logic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sumologic/sumo-logic-api/versions/18a824df1e78/schema)