---
title: "Search for tables"
method: POST
path: "/tables/search"
tags: ["tables"]
---

# Search for tables

`POST /tables/search`

Based on table properties (currently only name) search for tables. This could be an internal or an external table.

## Headers

- `x-budibase-app-id` string, required

## Request body

- NameSearch
  - `name` string, required — The name to be used when searching - this will be used in a case insensitive starts with match.

## Response `200`

Returns the found tables, based on the search parameters.

- TableSearch
  - `data` object[], required
    - `name` string, required — The name of the table.
    - `primaryDisplay` string — The name of the column which should be used in relationship tags when relating to this table.
    - `schema` object, required
    - `_id` string, required — The ID of the table.

---

[API](https://skmtc.net/budibase/apis/budibase-api.md) · [All operations](https://skmtc.net/budibase/apis/budibase-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/budibase/budibase-api/versions/9c6f16fc652b/schema)