Query data with the InfluxDB API

This page documents an earlier version of InfluxDB. InfluxDB v2.7 is the latest stable version. See the equivalent InfluxDB v2.7 documentation: Query data in InfluxDB.

The InfluxDB API is the primary means for querying data in InfluxDB (see the command line interface and client libraries for alternative ways to query the database).

Query data with the InfluxDB API using Flux or InfluxQL.

Note: The following examples use curl, a command line tool that transfers data using URLs. Learn the basics of curl with the HTTP Scripting Guide.

Query data with Flux

For Flux queries, the /api/v2/query endpoint accepts POST HTTP requests. Use the following HTTP headers:

  • Accept: application/csv
  • Content-type: application/vnd.flux

If you have authentication enabled, provide your InfluxDB username and password with the Authorization header and Token schema. For example: Authorization: Token username:password.

The following example queries Telegraf data using Flux: :

$ curl -XPOST localhost:8086/api/v2/query -sS \
  -H 'Accept:application/csv' \
  -H 'Content-type:application/vnd.flux' \
  -d 'from(bucket:"telegraf")
        |> range(start:-5m)
        |> filter(fn:(r) => r._measurement == "cpu")'  

Flux returns annotated CSV:


The header row defines column labels for the table. The cpu measurement has four points, each represented by one of the record rows. For example the first point has a timestamp of 2020-04-07T18:08:19.


Check out the Get started with Flux to learn more about building queries with Flux. For more information about querying data with the InfluxDB API using Flux, see the API reference documentation.

Query data with InfluxQL

To perform an InfluxQL query, send a GET request to the /query endpoint, set the URL parameter db as the target database, and set the URL parameter q as your query. You can also use a POST request by sending the same parameters either as URL parameters or as part of the body with application/x-www-form-urlencoded. The example below uses the InfluxDB API to query the same database that you encountered in Writing Data.

curl -G 'http://localhost:8086/query?pretty=true' --data-urlencode "db=mydb" --data-urlencode "q=SELECT \"value\" FROM \"cpu_load_short\" WHERE \"region\"='us-west'"

InfluxDB returns JSON:

    "results": [
            "statement_id": 0,
            "series": [
                    "name": "cpu_load_short",
                    "columns": [
                    "values": [

Note: Appending pretty=true to the URL enables pretty-printed JSON output. While this is useful for debugging or when querying directly with tools like curl, it is not recommended for production use as it consumes unnecessary network bandwidth.


Check out the Data Exploration page to get acquainted with InfluxQL. For more information about querying data with the InfluxDB API using InfluxQL, see the API reference documentation.

Was this page helpful?

Thank you for your feedback!

Set your InfluxDB URL

Introducing InfluxDB 3.0

The new core of InfluxDB built with Rust and Apache Arrow. Available today in InfluxDB Cloud Dedicated.

Learn more

State of the InfluxDB Cloud Serverless documentation

The new documentation for InfluxDB Cloud Serverless is a work in progress. We are adding new information and content almost daily. Thank you for your patience!

If there is specific information you’re looking for, please submit a documentation issue.