---
title: "Submit an event store query"
method: POST
path: "/meters/event-store-queries"
tags: ["Event Store"]
---

# Submit an event store query

`POST /meters/event-store-queries`

Submits a SQL-style asynchronous query to the Event Store to retrieve and inspect metering events for validation, troubleshooting, and reconciliation. The API returns a `queryId` that can be used to poll and fetch paginated results.

## Headers

- `Content-Type` string, required
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Track-Id` string

## Request body

- SubmitEventStoreQueryRequest
  - `query` string, required — The query clause.

## Response `200`

OK

- SubmitEventStoreQueryResponse
  - `success` boolean — Indicates whether the request was successful.
  - `data` object — Contains metadata and result details for the submitted event store query.
    - `queryId` string — Unique identifier of the submitted event store query. Use this ID to poll for status and fetch results.
  - `previousPage` string — Cursor or URL for the previous page of audit records, if available. Used for backward pagination.
  - `nextPage` string — Cursor or URL for the next page of audit records, if available. Used for forward pagination.
  - `error` Error
    - `code` string — Machine-readable error code identifying the failure type.
    - `message` string — Human-readable description of the error that provides more context about what went wrong.
    - `detail` object — Additional structured details about the error, such as validation issues or parameter-specific information.

## Other responses

- `400` — Bad Request - Invalid or missing parameters.
- `401` — Unauthorized - Authentication failed.
- `500` — Internal Server Error - Unexpected error.

---

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