Skip to content

HTTP Response Headers

The HTTP Query API and the ClickHouse HTTP servers send time zone, format, query ID, and query stats headers with each response. Streamed responses leave out X-Hdx-Query-Stats, as described in Streaming results.

Header Description Example
X-Clickhouse-Query-Id Unique query identifier 31f4cea6-dcbf-4438-8b9f-e2759f5a2b15
X-Clickhouse-Format Format of the response body JSON
X-Clickhouse-Timezone Time zone applied to the data UTC
X-Hdx-Query-Stats Query execution statistics, see detail exec_time=288 head_rows_read=1 [...omitted...] catalog_resp_time_ms=2.031186
HTTP/1.1 200 OK
Content-Encoding: gzip
Content-Type: application/json; charset=UTF-8
Date: Fri, 16 Oct 2026 20:28:48 GMT
Server: Hydrolix
Transfer-Encoding: chunked
X-Clickhouse-Format: JSON
X-Clickhouse-Query-Id: 31f4cea6-dcbf-4438-8b9f-e2759f5a2b15
X-Clickhouse-Timezone: UTC
X-Hdx-Query-Stats: exec_time=288 head_rows_read=1 head_bytes_read=16 peer_rows_read=747943 peer_bytes_read=5983544 num_partitions=8 num_peers=1 result_rows=1 query_attempts=1 memory_usage=13753395 catalog_resp_time_ms=2.031186

X-Hdx-Query-Stats⚓︎

The Query stats supply the following information.

Query_stat Description
exec_time Execution time of the query in milliseconds
catalog_resp_time_ms Execution time of catalog query in milliseconds
num_partitions Number of HDX partitions accessed to answer the query
memory_usage Memory used in bytes
head_rows_read Count of rows handled by the query head
head_bytes_read Number of uncompressed bytes parsed to answer the query
num_peers Number of query peers accessed to answer the query
query_attempts Number of total times the query was tried, usually, 1
peer_rows_read Count of rows read by all query peers
peer_bytes_read Number of uncompressed bytes parsed by query peers
result_rows Count of rows in the response set