---
title: "Run Natural Language Queries on a Collection"
method: POST
path: "/api/collections/data/fetch/natural-query"
tags: ["Database Management"]
---

# Run Natural Language Queries on a Collection

`POST /api/collections/data/fetch/natural-query`

Run Natural Language Queries on a Collection. Describe the data that you want to fetch from a Collection in a natural language format and we will run the query for you.

## Request body

- object
  - `collection` string — The Name of the Collection or the Group where you want to store all your data.
  - `query` string — The Query that you want to run on the Collection. Describe the data that you want to fetch from a Collection in a natural language format and we will run the query for you.
  - `outputType` 'json' | 'stream' | 'file' — The type of output you want. `json` will return the data as a JSON object that is parseable. `stream` will return the data as a stream of data and `file` will return the data as a parseable CSV file.

## Response `200`

Output from the Database Collection Fetch Process

- object
  - `status` string — Status indicating the success of the text moderation.
  - `processing_time` integer — The time taken to process the request, in milliseconds.
  - `processing_id` string — A universally unique identifier for the request. This can be used to track the request in the logs.
  - `processing_count` integer — The number of times the request has been processed. This is what is considered in the Billing Process. This is either the number of times the image is processed or the number of words that the server processes.
  - `data` object
    - `databaseId` string — The ID of the Database where the data is stored.
    - `collection` string — The Name of the Collection or the Group where you want to store all your data.
    - `elapsed_time` integer — The time taken to process the request, in milliseconds.
    - `data` object[]
      - `sampleDbContent` string — The data that is stored in the Collection.
      - `sampleDbContent2` string — The data that is stored in the Collection.

## Other responses

- `400` — Bad Request.
- `401` — Unauthorized
- `404` — Not Found
- `406` — Not Acceptable
- `500` — Internal Server Error

---

[API](https://skmtc.net/worqhat/apis/worqhat-ai-api-endpoints-2.md) · [All operations](https://skmtc.net/worqhat/apis/worqhat-ai-api-endpoints-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/worqhat/worqhat-ai-api-endpoints-2/versions/fc369f69a3e6/schema)