v1

latestOpenAPI 3.0.3MIT OR Apache-2.02026-07-17203670.3 KB
query

Execute an RQL query

Execute SQL-like queries against documents using ReasonDB Query Language (RQL).

Supports:

  • WHERE clauses for filtering by tags, author, metadata
  • SEARCH clause for BM25 full-text search (fast keyword matching)
  • REASON clause for LLM semantic search (intelligent answer extraction)
  • GROUP BY and aggregate functions (COUNT, SUM, AVG)
  • EXPLAIN to view query execution plans
post/v1/query

Request body

querystring required

RQL query string

timeout_msinteger

Optional timeout in milliseconds

Example request

{
  "query": "SELECT * FROM legal WHERE author = 'Alice' LIMIT 10"
}

Response

Query executed successfully

total_countinteger

Total count before pagination

execution_time_msinteger

Execution time in milliseconds