Athena

Fetch data via GET

Compatibility GET wrapper for fetch semantics. Converts query string filters and paging inputs into an internal fetch-style request. Use `sort_by`/`sort_direction` for simple ordering and the aggregation query parameters for grouped output.

GET
/data

Query Parameters

view*string
eq_column*string
eq_value*string
columns?string
limit?integer
current_page?integer
page_size?integer
offset?integer
total_pages?integer
strip_nulls?boolean
sort_by?string

Column name to sort by (forwarded as sortBy.field in the internal POST)

sort_direction?string

Sort direction (default asc)

Value in"asc" | "desc" | "ascending" | "descending"
group_by?string

Column name to group results by

time_granularity?string

Time granularity for grouping timestamp data

Value in"day" | "hour" | "minute"
aggregation_column?string

Column to aggregate (required when using aggregation_strategy)

aggregation_strategy?string

Aggregation strategy to apply (requires aggregation_column)

Value in"cumulative_sum"
aggregation_dedup?boolean

Whether to deduplicate during aggregation

Header Parameters

X-User-Id?string
X-Athena-Client?string
X-Strip-Nulls?string
apikey?string
x-api-key?string

optional API key mirror of the apikey header

x-supabase-url?string

Optional custom Supabase URL when X-Athena-Client is custom_supabase

Formaturi
x-supabase-key?string

Optional custom Supabase key when X-Athena-Client is custom_supabase

Response Body

curl -X GET "https://athena-cluster.com/data?view=string&eq_column=string&eq_value=string"
Empty
Empty
Empty

Cluster mirror health and version checks GET

Checks Athena mirror domains, returns reachability, latency, throughput, and reported version metadata.

Cached row count (COUNT query or table reference) POST

Returns a single row count using the same cache layers as gateway fetch (in-process + Redis when configured). Provide either validated `query` (single SELECT COUNT ... with no GROUP BY / UNION / comments) or `table_name` with optional `table_schema` (default `public`). `Cache-Control: no-cache` bypasses the cache. Responses include `X-Athena-Cached`, `X-Athena-Cache-Outcome`, and `X-Athena-Cache-Source` when applicable.