Submit asynchronous query

post

https://api.mira.co/v1/ams/query/async

Submit a query for asynchronous processing. Returns immediately with a job ID.

Use this endpoint for:

Large queries spanning many assets or long time periods
Complex queries with multiple groupby dimensions
Queries that may exceed synchronous timeout limits

Workflow:

Submit query via this endpoint → receive job_id
Poll GET /v1/query/async/{job_id} for status
When status is completed, fetch results via GET /v1/query/async/{job_id}/results

Jobs are retained for 24 hours after completion.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Request body for the measurement query endpoint.

Queries return aggregated OOH measurement metrics (impressions, reach,
frequency, GRPs, TRPs) filtered and grouped by various dimensions.

You can submit a query in two ways:

Structured JSON: Provide select, filters, audience, time, and
other fields as structured objects.
DSL String: Provide a SQL-like query string in the query field.
When query is provided, all other fields are ignored.

Results are subject to aggregation thresholds to protect privacy.

query

SQL-like DSL query string. When provided, all other fields are ignored and the query is parsed from this string. Example: SELECT total(imps), total(reach) FROM audience FOR AUDIENCE universe_id=1 WHERE dma_id IN (501) DURING '2025-01-01' TO '2025-01-28' GROUP BY operator ORDER BY imps DESC LIMIT 20. See the Query DSL documentation for full syntax reference.

select

array | null

Metrics to calculate and return. Required if query is not provided.

filters

array | null

Filter constraints. Multiple filters are combined with OR logic. Required if query is not provided.

audience

AudienceDefinition | null

Population universe and optional target segment for rating calculations. Required if query is not provided.

time

TimeFilter | null

Time range and temporal settings. Required if query is not provided.

layer

string

enum

Defaults to audience

Exposure measurement layer to use for calculations.

Allowed:

model_version_id

Pin to a specific model version for reproducibility. If omitted, uses the latest published version.

groupby

array | null

Dimensions to group results by. If omitted, returns a single total row.

order_by

array | null

Sort order for results.

limit

Maximum number of rows to return.

page_token

Pagination token from a previous response.

Responses

200Successful Response

400Invalid query request

422Validation Error

429Rate limit exceeded

500Internal server error