---
title: "/essentials/lookup/{filter_name}"
method: GET
path: "/lookup/{filter_name}"
---

# /essentials/lookup/{filter_name}

`GET /lookup/{filter_name}`

Provides a list of all the human-readable search values within a specific filter_name table, which can then be used in search queries with the Essentials endpoints. Each array contains a table key, name value, and search value. The resulting search_value(s) can be passed as search values in the Essentials API.

## Path parameters

- `filter_name` string, required

## Response `200`

OK

- object
  - `code` integer — HTTP response status code.
  - `message` string
  - `took` integer
  - `errors` string[]
  - `data` object[] — A list of all the tables used as a filter_name with the Essentials Lookup endpoints
    - `key` string — Code for the filter_name results
    - `value` string — Text for the filter_name results
    - `search_value` string — Value to pass in Essential's API filters

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — No Results Found
- `406` — Not Acceptable
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/candid/apis/rfpapi.md) · [All operations](https://skmtc.dev/candid/apis/rfpapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/candid/rfpapi/revisions/bb9133e46de6/schema)