--- title: Use the InfluxDB v1 HTTP query API and InfluxQL description: Use the InfluxDB v1 HTTP query API to query data in InfluxDB Cloud Serverless with InfluxQL. url: https://docs.influxdata.com/influxdb3/cloud-serverless/query-data/execute-queries/v1-http/ estimated_tokens: 1967 publisher: InfluxData canonical: https://docs.influxdata.com/influxdb3/cloud-serverless/query-data/execute-queries/v1-http/ date: '2026-05-15T15:46:14-06:00' lastmod: '2026-05-15T15:46:14-06:00' --- * InfluxQL Use the InfluxDB v1 HTTP API `/query` endpoint and InfluxQL to query data stored in InfluxDB Cloud Serverless and return results in JSON or CSV format. The `/query` endpoint provides compatibility for InfluxDB 1.x workloads that you bring to InfluxDB 3. *Before you can use the v1 query API,[databases and retention policies must be mapped to buckets](/influxdb3/cloud-serverless/guides/api-compatibility/v1/#map-v1-databases-and-retention-policies-to-buckets).* #### Flight queries don’t use DBRP mappings When using Flight RPC or Flight SQL to query InfluxDB, specify the **bucket name**. Flight queries don’t use DBRP mappings. See how to [get started querying with Flight and SQL or InfluxQL](/influxdb3/cloud-serverless/get-started/query/). * [Query the v1 /query endpoint](#query-the-v1-query-endpoint) * [Parameters](#parameters) * [Authorization](#authorization) * [Return results as JSON or CSV](#return-results-as-json-or-csv) * [Tools for querying the v1 API](#tools-for-querying-the-v1-api) * [Interactive clients](#interactive-clients) * [Troubleshoot failures](#troubleshoot-failures) * [Database not found](#database-not-found) * [Quota and limit errors](#quota-and-limit-errors) ## Query the v1 /query endpoint To query using HTTP and InfluxQL, send a `GET` or `POST` request to the v1 `/query` endpoint. ``` GET https://cloud2.influxdata.com/query ``` ### Parameters For InfluxDB Cloud Serverless v1 API `/query` requests, set parameters as listed in the following table: | Parameter | Allowed in |Ignored| Value | |-------------------------------------------------------|------------|-------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `chunked` |Query string|Honored|Returns points in streamed batches instead of in a single response. If set to `true`, InfluxDB chunks responses by series or by every 10,000 points, whichever occurs first.| | `chunked_size` |Query string|Honored| **Requires `chunked` to be set to `true`**. If set to a specific value, InfluxDB chunks responses by series or by this number of points. | | `db` |Query string|Honored| Database name [mapped to a bucket](/influxdb3/cloud-serverless/guides/api-compatibility/v1/#map-v1-databases-and-retention-policies-to-buckets) | | `epoch` |Query string|Honored| [Timestamp precision](#timestamp-precision) | | `pretty` |Query string|Ignored| N/A | | `rp` |Query string|Honored| Retention policy [mapped to a bucket](/influxdb3/cloud-serverless/guides/api-compatibility/v1/#map-v1-databases-and-retention-policies-to-buckets) | | `q` |Query string|Honored| [InfluxQL](/influxdb3/cloud-serverless/query-data/influxql/) | |[`Authorization` header or `u` and `p`](#authorization)| | | [Token](#authorization) | > [!Note] > When bringing v1 API workloads to InfluxDB Cloud Serverless, you’ll need to adjust request parameters in your client configuration or code. #### Timestamp precision Use one of the following values for timestamp precision (`epoch`): * `ns`: nanoseconds * `us`: microseconds * `ms`: milliseconds * `s`: seconds * `m`: minutes * `h`: hours ### Authorization To authorize a query request, include a [token](/influxdb3/cloud-serverless/admin/tokens/) that has read permission for the bucket. Use [`Token` authentication](/influxdb3/cloud-serverless/guides/api-compatibility/v1/#authenticate-with-a-token-scheme) or v1-compatible [username and password authentication](/influxdb3/cloud-serverless/guides/api-compatibility/v1/#authenticate-with-a-username-and-password-scheme) to include a token in the request. ### Return results as JSON or CSV By default, the `/query` endpoint returns results in **JSON** format. To return results in CSV format, include the `Accept` header with the `application/csv` or `text/csv` MIME type–for example: ```sh curl --get https://cloud2.influxdata.com/query \ --header "Authorization: Token DATABASE_TOKEN" \ --header "Accept: application/csv" \ --data-urlencode "db=DATABASE_NAME" \ --data-urlencode "q=SELECT * FROM home" ``` ## Tools for querying the v1 API ### Interactive clients To test InfluxDB v1 API queries interactively from the command line, use common HTTP clients such as cURL and Postman. #### Token Auth #### ```sh curl https://cloud2.influxdata.com/query \ --header "Authorization: Token API_TOKEN" \ --data-urlencode "db=DATABASE_NAME" \ --data-urlencode "q=SELECT * FROM home" ``` Replace the following: * `DATABASE_NAME`: the [database name mapped to the bucket](/influxdb3/cloud-serverless/guides/api-compatibility/v1/#map-v1-databases-and-retention-policies-to-buckets) * `API_TOKEN`: an [API token](/influxdb3/cloud-serverless/admin/tokens/) with *read* access to the specified database. ```sh curl --get https://cloud2.influxdata.com/query \ -user "":"API_TOKEN" \ --data-urlencode "db=DATABASE_NAME" \ --data-urlencode "q=SELECT * FROM home" ``` ```sh curl --get https://cloud2.influxdata.com/query \ --data-urlencode "u=ignored" \ --data-urlencode "p=DATABASE_TOKEN" \ --data-urlencode "db=DATABASE_NAME" \ --data-urlencode "q=SELECT * FROM home" ``` ## Troubleshoot failures Troubleshoot problems and errors encountered when using the HTTP API to query InfluxDB Cloud Serverless. ### Database not found If a DBRP doesn’t exist for the `db=DATABASE_NAME` and `rp=RETENTION_POLICY_NAME` combination in the query request, the response body contains an error message, for example `"database not found:..."`. ### Quota and limit errors HTTP API `/query` requests are subject to [usage quotas and limits](/influxdb3/cloud-serverless/admin/billing/). #### Related * [Use the InfluxDB v1 HTTP API](/influxdb3/cloud-serverless/guides/api-compatibility/v1/) | Parameter | Allowed in | Ignored | Value | | --- | --- | --- | --- | | Parameter | Allowed in | Ignored | Value | | chunked | Query string | Honored | Returns points in streamed batches instead of in a single response. If set to true , InfluxDB chunks responses by series or by every 10,000 points, whichever occurs first. | | chunked_size | Query string | Honored | Requires chunked to be set to true . If set to a specific value, InfluxDB chunks responses by series or by this number of points. | | db | Query string | Honored | Database name mapped to a bucket | | epoch | Query string | Honored | Timestamp precision | | pretty | Query string | Ignored | N/A | | rp | Query string | Honored | Retention policy mapped to a bucket | | q | Query string | Honored | InfluxQL | | Authorization header or u and p | | | Token |