Retrieve a list of datasets

curl --request GET \
  --url https://api.eu.bronto.io/datasets \
  --header 'X-BRONTO-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-BRONTO-API-KEY': '<api-key>'}};

fetch('https://api.eu.bronto.io/datasets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.eu.bronto.io/datasets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-BRONTO-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.eu.bronto.io/datasets"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-BRONTO-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.eu.bronto.io/datasets")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-BRONTO-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "datasets": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "collection": "demo",
      "dataset": "firewall",
      "is_system_generated": false,
      "tags": {
        "region": "eu",
        "environment": "production"
      },
      "parser_id": "266ea07d-b013-47c1-9c74-635e42b22cbb",
      "parser_matching_exempt": false,
      "metadata": {
        "created_at": 123,
        "created_by": {
          "type": "API_KEY_ID",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        },
        "modified_at": 123,
        "modified_by": {
          "type": "API_KEY_ID",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        },
        "deleted_at": 123,
        "deleted_by": {
          "type": "API_KEY_ID",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        },
        "last_heartbeat_at": 1791331200000
      }
    }
  ]
}

{
  "code": 429,
  "type": "Too Many Requests",
  "correlation_id": "53909ed43c544531b7a555e295960437",
  "details": "Rate limit exceeded. Maximum 100 requests are allowed within a 5-minute window."
}

{
  "code": 500,
  "type": "Internal Server Error",
  "correlation_id": "b129b8e0e66c41aa9541a30f67e38ce2",
  "details": "Internal Server Error"
}

{
  "code": 500,
  "type": "Internal Server Error",
  "correlation_id": "b129b8e0e66c41aa9541a30f67e38ce2",
  "details": "Internal Server Error"
}

GET

datasets

Retrieve a list of datasets

curl --request GET \
  --url https://api.eu.bronto.io/datasets \
  --header 'X-BRONTO-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-BRONTO-API-KEY': '<api-key>'}};

fetch('https://api.eu.bronto.io/datasets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.eu.bronto.io/datasets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-BRONTO-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.eu.bronto.io/datasets"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-BRONTO-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.eu.bronto.io/datasets")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-BRONTO-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "datasets": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "collection": "demo",
      "dataset": "firewall",
      "is_system_generated": false,
      "tags": {
        "region": "eu",
        "environment": "production"
      },
      "parser_id": "266ea07d-b013-47c1-9c74-635e42b22cbb",
      "parser_matching_exempt": false,
      "metadata": {
        "created_at": 123,
        "created_by": {
          "type": "API_KEY_ID",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        },
        "modified_at": 123,
        "modified_by": {
          "type": "API_KEY_ID",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        },
        "deleted_at": 123,
        "deleted_by": {
          "type": "API_KEY_ID",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        },
        "last_heartbeat_at": 1791331200000
      }
    }
  ]
}

{
  "code": 429,
  "type": "Too Many Requests",
  "correlation_id": "53909ed43c544531b7a555e295960437",
  "details": "Rate limit exceeded. Maximum 100 requests are allowed within a 5-minute window."
}

{
  "code": 500,
  "type": "Internal Server Error",
  "correlation_id": "b129b8e0e66c41aa9541a30f67e38ce2",
  "details": "Internal Server Error"
}

{
  "code": 500,
  "type": "Internal Server Error",
  "correlation_id": "b129b8e0e66c41aa9541a30f67e38ce2",
  "details": "Internal Server Error"
}

Authorizations

X-BRONTO-API-KEY

string

header

required

Query Parameters

from

string[]

The ids of the datasets to filter the list by. At most one of from or from_expr may be provided. Both parameters are optional; if neither is provided, all datasets are returned. If none of the requested ids match an existing dataset, a 200 response with an empty datasets array is returned.

Minimum array length: 1

from_expr

string

Expression used to select the set of datasets to return. The expression defines the criteria for which datasets are included and is applied across all available datasets to produce the result set. Supports logical operators (AND, OR), comparison operators (=, !=), and quoted string literals. At most one of from or from_expr may be provided. Both parameters are optional; if neither is provided, all datasets are returned. If the expression matches no datasets, a 200 response with an empty datasets array is returned.

Response

A list of datasets

datasets

object[]

Show child attributes

API overview

api-keys

users

groups

search

context

live-tail

logs

datasets

monitors

dashboards

collections

access

downtimes

events

forward

roles

top-keys

widgets

integrations

exports

customers

tags

limits

permissions

ai

policies

encryption-keys

metrics

timeseries

patterns

Retrieve a list of datasets

Authorizations

Query Parameters

Response