Skip to main content
GET
/
1
/
datasets
List All Datasets
curl --request GET \
  --url https://api.honeycomb.io/1/datasets \
  --header 'X-Honeycomb-Team: <api-key>'
[
  {
    "name": "my dataset!",
    "description": "my dataset described!",
    "slug": "my-dataset-",
    "expand_json_depth": 2,
    "created_at": "2022-07-21T18:39:23Z",
    "last_written_at": "2022-07-22T19:52:00Z",
    "regular_columns_count": 12
  },
  {
    "name": "another dataset",
    "description": "",
    "slug": "another-dataset",
    "expand_json_depth": 0,
    "created_at": "2022-07-21T18:39:23Z",
    "last_written_at": "2022-07-22T19:52:00Z",
    "regular_columns_count": 98
  }
]

Authorizations

​
X-Honeycomb-Team
string
header
required

Authenticate using a Honeycomb Configuration Key.

Pass the Token in the X-Honeycomb-Team header:

X-Honeycomb-Team: 1234567890123456789012

If you created your key using the API, use data.attributes.secret; this is the same value as the Token in the UI.

To learn how to create a Configuration Key, visit Manage Environment API Keys. To learn more about authenticating requests, visit API Authentication.

Response

Success

​
name
string
required

The name of the dataset.

Required string length: 1 - 255
Example:

"My Dataset!"

​
description
string
default:""

A description for the dataset.

Maximum string length: 1024
Example:

"A nice description of my dataset"

​
settings
object
​
expand_json_depth
integer
default:0

The maximum unpacking depth of nested JSON fields.

Required range: 0 <= x <= 10
Example:

3

​
slug
string
read-only

The 'slug' of the dataset to be used in URLs.

Example:

"my-dataset-"

​
regular_columns_count
null | integer
read-only

The total number of unique fields for this Dataset. The value will be null if the dataset does not contain any fields yet.

Example:

100

​
last_written_at
null | string
read-only

The ISO8601-formatted time when the dataset last received event data. The value will be null if no data has been received yet.

Example:

"2022-07-21T18:39:23Z"

​
created_at
string
read-only

The ISO8601-formatted time when the dataset was created.

Example:

"2022-09-22T17:32:11Z"

​
dataset_type
enum<string>
read-only

The type of data contained in the dataset. Only present for time-series metrics datasets.

Available options:
metrics
Example:

"metrics"