http.get() function

http.get() is experimental and subject to change at any time.

http.get() submits an HTTP GET request to the specified URL and returns the HTTP status code, response body, and response headers.


Experimental http.get() is deprecated in favor of requests.get().

Response format

http.get() returns a record with the following properties:

  • statusCode: HTTP status code returned by the GET request (int).
  • body: HTTP response body (bytes).
  • headers: HTTP response headers (record).
Function type signature
(url: string, ?headers: A, ?timeout: duration) => {statusCode: int, headers: B, body: bytes} where A: Record, B: Record
For more information, see Function type signatures.



(Required) URL to send the GET request to.


Headers to include with the GET request.


Timeout for the GET request. Default is 30s.


Get the status of an InfluxDB OSS instance

import "experimental/http"

    url: "http://localhost:8086/health",
    headers: {Authorization: "Token mY5up3RS3crE7t0k3N", Accept: "application/json"},

Was this page helpful?

Thank you for your feedback!

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.