Retrieve a dataset
Retrieve a dataset
One dataset with its event count, field count and retention.
Accepts the dataset name or its ds_… id.
GET
/v1/datasets/{name}Path parameters
namestringrequiredDataset name or ds_….
curl -X GET https://api.logstreem.com/v1/datasets/{name} \
-H "Authorization: Bearer $LOGSTREEM_TOKEN"Responses
200OK
{
"object": "dataset",
"id": "ds_9f2c7b1a4d8e0c3f6a5b",
"name": "api-gateway-prod",
"description": "Production dataset.",
"events": 14200000000,
"fields": 148,
"retention_days": 400,
"region": "us-east",
"created_at": "2026-04-11T12:00:00.000Z"
}401Unauthorized
{
"error": {
"type": "authentication_error",
"code": "missing_token",
"message": "No API token provided.",
"doc_url": "https://logstreem.com/docs/errors#missing_token",
"request_id": "req_9f3c2a7b41de08c5b2e6"
}
}Try itsandbox