Query Semantic Model
Execute a metric query against a semantic model. Specify measures, optional dimensions, filters, and time dimensions. Returns structured data rows.
Authentication
X-API-KEYstring
API Key authentication via header
Path parameters
asset_id
Request
This endpoint expects an object.
measures
List of measure identifiers, e.g. [“orders.total_revenue”]
dimensions
Optional dimension identifiers for grouping
filters
Optional filters
limit
Maximum rows to return (default 100). When the result was cut at this limit the response sets “truncated”: true.
order
Optional ordering as [member, direction] pairs applied before “limit”, e.g. [[“orders.count”, “desc”]] for a server-side top-N. Direction must be “asc” or “desc”.
time_dimensions
Optional time dimension configs
Response
Successful Response
data
Query result rows
row_count
Number of rows returned
elapsed_ms
Server-side execution time in milliseconds (semantic layer + engine, excluding network) — surface it to show how fast the engine answered
truncated
True when the query produced more rows than ‘limit’ and the result was cut; raise ‘limit’ or add filters to see the rest
Errors
401
Unauthorized Error
404
Not Found Error
422
Unprocessable Entity Error
502
Bad Gateway Error