---
title: "Query the system and service state by using SQL."
method: POST
path: "/query"
tags: ["introspection"]
---

# Query the system and service state by using SQL.

`POST /query`

## Request body

- QueryRequest
  - `query` string, required — SQL query to run against the storage

## Response `200`

Query results

## Other responses

- `500` — Datafusion error
- `503` — Query service not available

## Changes

> 8 revisions in range; 1 could not be searched.

- **2026-01-30** `059a44500a5c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/restatedev/apis/admin-api/changes/query/post.md)

---

[API](https://skmtc.dev/restatedev/apis/admin-api.md) · [All operations](https://skmtc.dev/restatedev/apis/admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/restatedev/admin-api/revisions/5361f4818c71/schema)