---
title: "Execute SQL query"
method: POST
path: "/v1/helicone-sql/execute"
tags: ["HeliconeSql"]
---

# Execute SQL query

`POST /v1/helicone-sql/execute`

Execute a SQL query against ClickHouse

## Request body

- ExecuteSqlRequest
  - `sql` string, required

## Response `200`

Query results with rows and metadata

- union
  - ResultSuccessExecuteSqlResponse
    - `data` ExecuteSqlResponse, required
      - `rowCount` number, double, required
      - `size` number, double, required
      - `elapsedMilliseconds` number, double, required
      - `rows` RecordStringAny[], required
    - `error` null, nullable, required
  - ResultErrorString
    - `data` null, nullable, required
    - `error` string, required

---

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