---
title: "Nl Query Database"
method: POST
path: "/api/v1/databases/{database_id}/nl_query"
tags: ["databases"]
---

# Nl Query Database

`POST /api/v1/databases/{database_id}/nl_query`

Translate a natural-language question into DuckDB SQL and execute it.

## Path parameters

- `database_id` string, uuid, required

## Query parameters

- `limit` integer

## Request body

- NLQueryRequest
  - `question` string, required

## Response `200`

Successful Response

- NLQueryResponse — NL → SQL response. ``sql`` is the generated query so the SQL editor can show it back to the user; rows/columns are the executed result.
  - `title` string, required
  - `sql` string, required
  - `columns` string[], required
  - `rows` object[], required
  - `total_rows` integer, required
  - `truncated` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/netter/apis/dmi-backend.md) · [All operations](https://skmtc.net/netter/apis/dmi-backend/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netter/dmi-backend/versions/a59877bf911b/schema)