---
title: "Execute a read-only query against a Flow App"
method: GET
path: "/flow/apps/{appId}/query/{queryId}"
tags: ["Flow Query"]
---

# Execute a read-only query against a Flow App

`GET /flow/apps/{appId}/query/{queryId}`

Queries app-scoped state without starting a session. The `queryId` must match a
query handler registered by the app via `app.query(id, handler)`.

## Path parameters

- `appId` string, required
- `queryId` string, required

## Response `200`

Query result

- object
  - `data` unknown, required

## Other responses

- `400` — Bad request (RFC 7807)
- `401` — Unauthorized (RFC 7807)
- `404` — Not found (RFC 7807)

---

[API](https://skmtc.net/overledger/apis/overledger-server.md) · [All operations](https://skmtc.net/overledger/apis/overledger-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/overledger/overledger-server/revisions/dd31e0a52064/schema)