---
title: "SQL Query"
method: POST
path: "/v1/sql"
tags: ["SQL"]
---

# SQL Query

`POST /v1/sql`

Execute a SQL query and return the results.

This endpoint allows users to execute SQL queries directly from an HTTP request. The SQL query is sent as plain text in the request body.

## Headers

- `Accept` string, required

## Request body

- unknown

## Response `200`

SQL query executed successfully

- unknown[]
  - unknown

## Other responses

- `400` — Invalid SQL query or malformed input
- `500` — Internal server error

## Changes

> 53 revisions in range; 26 could not be searched.

- **2025-03-18** `dd94571fef79` — 2 breaking
  - removed the media type `application/json` from the request body
  - removed the media type `application/vnd.spiceai.sql.v1+json` for the response with the status `200`

[Change history](https://skmtc.dev/spiceai/apis/runtime/changes/v1/sql/post.md)

---

[API](https://skmtc.dev/spiceai/apis/runtime.md) · [All operations](https://skmtc.dev/spiceai/apis/runtime/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spiceai/runtime/revisions/fb597a4eaa56/schema)