---
title: "Execute raw SQL table search"
method: POST
path: "/v1/spatial/tables/search"
tags: ["Advanced Querying - Queries"]
---

# Execute raw SQL table search

`POST /v1/spatial/tables/search`

## Request

- Base URL: `https://api.cloud.precisely.com`
- URL: `https://api.cloud.precisely.com/v1/spatial/tables/search`
- Auth: one of:
  - `bearerAuth` (a scheme the document does not define)
  - `ApiKeyAuth` (a scheme the document does not define)

Executes a raw MI SQL SELECT provided in the request body, with optional bound parameters, pagination, and micro-batch execution. When 'parametersList' is present (and 'parameters' is absent), the response is a JSON array of FeatureCollections — one per parameter set — instead of a single FeatureCollection.

## Query parameters

- `page` string
- `pageLength` string
- `l` string

## Headers

- `X-Request-Id` string

## Request body

- string

## Response `200`

Query executed successfully

## Other responses

- `400`: Invalid, missing, or malformed 'query'/'parametersList' in the request body
- `401`: Unauthorized: Invalid token
- `403`: Forbidden
- `404`: Table not found
- `429`: Too many requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/precisely/apis/feature-api.md) · [All operations](https://skmtc.dev/precisely/apis/feature-api/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/feature-api/revisions/6dc26f89c0aa?raw)