How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

InfluxDB Query API

Retrieve data, analyze queries, and get query suggestions.

InfluxDB Query API is one of 40 APIs that InfluxDB publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Query. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, authentication docs, and a getting-started guide.

This API exposes 5 operations across 5 paths, and defines 53 schemas. It is described by OpenAPI 3.2.0.

Requests are made against the base URL https://cloud2.influxdata.com/api/v2.

5 operations 5 paths 53 schemas 2 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
Base URL
https://cloud2.influxdata.com/api/v2
Authentication
HTTP Basic, API Key
Resource Areas
1

Authentication & Security 2

InfluxDB Query API declares 2 security schemes for authenticating requests. It accepts HTTP basic authentication (BasicAuthentication). An API key is passed in the header as Authorization (TokenAuthentication). By default, every request must be authenticated.

  • BasicAuthentication — Basic authentication scheme Use the HTTP Basic authentication scheme for InfluxDB /api/v2 API operations that support it: Syntax Authorization: Basic BASE64ENC…
  • TokenAuthentication — Use the [Token authentication](section/Authentication/TokenAuthentication) scheme to authenticate to the InfluxDB API. In your API requests, send an Authorizat…

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 2 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Query 5

Retrieve data, analyze queries, and get query suggestions.

POST
/api/v2/query
Query data
PostQuery 5 params body → 200400401404429500default
POST
/api/v2/query/analyze
Analyze a Flux query
PostQueryAnalyze 2 params body → 200400default
POST
/api/v2/query/ast
Generate a query Abstract Syntax Tree (AST)
PostQueryAst 2 params body → 200400default
GET
/api/v2/query/suggestions
List Flux query suggestions
GetQuerySuggestions 1 param → 200301default
GET
/api/v2/query/suggestions/{name}
Retrieve a query suggestion for a branching suggestion
GetQuerySuggestionsName 2 params → 200500

Schemas 53

The contract defines 53 schemas that model the data the API accepts and returns. The most detailed are Query (6 properties), File (5 properties), Dialect (5 properties), ConditionalExpression (4 properties). Each schema is shown below with its type and property counts.

UnsignedIntegerLiteral
object
Represents integer numbers
2 properties
FunctionExpression
object
Function expression
3 properties
BuiltinStatement
object
Declares a builtin identifier and its type
2 properties
CallExpression
object
Represents a function call
3 properties
PipeExpression
object
Call expression with pipe argument
3 properties
UnaryExpression
object
Uses operators to act on a single operand in an expression
3 properties
MemberExpression
object
Represents accessing a property of an object
3 properties
ASTResponse
object
Contains the AST for the supplied Flux query
1 property
MemberAssignment
object
Object property assignment
3 properties
PackageClause
object
Defines a package identifier
2 properties
File
object
Represents a source from a single file
5 properties
Identifier
object
A valid Flux identifier
2 properties
PropertyKey
NodeType
string
Type of AST node
Property
object
The value associated with a key
3 properties
ParenExpression
object
Represents an expression wrapped in parenthesis
2 properties
ExpressionStatement
object
May consist of an expression that doesn't return a value and is executed solely for its side-effects
2 properties
PipeLiteral
object
Represents a specialized literal value, indicating the left hand value of a pipe expression
1 property
RegexpLiteral
object
Expressions begin and end with / and are regular expressions with syntax accepted by RE2
2 properties
Duration
object
A pair consisting of length of time and the unit of time measured. It is the atomic unit from which all duration literals are composed.
3 properties
LogicalExpression
object
Represents the rule conditions that collectively evaluate to either true or false
4 properties
BooleanLiteral
object
Represents boolean values
2 properties
DurationLiteral
object
Represents the elapsed time between two instants as an int64 nanosecond count with syntax of golang's time.Duration
2 properties
FluxSuggestions
object
1 property
TestStatement
object
Declares a Flux test case
2 properties
Error
object
4 properties 1 required
ImportDeclaration
object
Declares a package import
3 properties
StringLiteral
object
Expressions begin and end with double quote marks
2 properties
Dialect
object
Options for tabular data output. Default output is [annotated CSV](https://docs.influxdata.com/influxdb/cloud/reference/syntax/annotated-csv/csv-response-forma…
5 properties
ConditionalExpression
object
Selects one of two expressions, Alternate or Consequent, depending on a third boolean expression, Test
4 properties
ObjectExpression
object
Allows the declaration of an anonymous object within a declaration
2 properties
ErrorCode
string
code is the machine-readable error code.
ArrayExpression
object
Used to create and directly specify the elements of an array object
2 properties
FluxSuggestion
object
2 properties
Package
object
Represents a complete package source tree.
4 properties
FloatLiteral
object
Represents floating point numbers according to the double representations defined by the IEEE-754-1985
2 properties
VariableAssignment
object
Represents the declaration of a variable
3 properties
Statement
Node
DateTimeLiteral
object
Represents an instant in time with nanosecond precision in [RFC3339Nano date/time format](https://docs.influxdata.com/influxdb/cloud/reference/glossary/rfc3339…
2 properties
ReturnStatement
object
Defines an expression to return
2 properties
DictExpression
object
Used to create and directly specify the elements of a dictionary
2 properties
IntegerLiteral
object
Represents integer numbers
2 properties
BinaryExpression
object
uses binary operators to act on two operands in an expression
4 properties
LanguageRequest
object
Flux query to be analyzed.
1 property 1 required
Query
object
Query InfluxDB with the Flux language
6 properties 1 required
OptionStatement
object
A single variable declaration
2 properties
Expression
DictItem
object
A key-value pair in a dictionary.
3 properties
IndexExpression
object
Represents indexing into an array
3 properties
Block
object
A set of statements
2 properties
BadStatement
object
A placeholder for statements for which no correct statement nodes can be created
2 properties
AnalyzeQueryResponse
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

influxdb-query-api-openapi.yml Raw ↑

Other APIs InfluxDB publishes across the network.

InfluxDB Authorizations (API tokens) API
InfluxDB Bucket Schemas API
InfluxDB Buckets API
InfluxDB Cells API
InfluxDB Checks API
InfluxDB Config API
InfluxDB Dashboards API
InfluxDB Data I/O endpoints API
InfluxDB DBRPs API
InfluxDB Delete API
InfluxDB Invokable Scripts API
InfluxDB Labels API
Where this information came from

This is an independent, third-party profile of InfluxDB Query API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.