Explore documentation
  1. Welcome to Warehouse 👋
  2. Ingesting data
    1. Ingesting events
    2. S3 vs NVMe hosted data
    3. Host events in your S3 bucket
  3. Querying data
    1. Querying events & time series
    2. Writing ClickHouse SQL queries
    3. Query speeds
    4. Ad-hoc SQL API
    5. Generate client-facing APIs
    6. Visualizing data
  4. Vector embeddings
    1. Introduction to embeddings
    2. Using built-in embeddings
    3. Bringing your own embeddings
    4. Data structures and indices
  5. Use cases
    1. Retrieval Augmented Generation
  6. Management
    1. Controlling costs
  7. Warehouse API
    1. Getting an API token
    2. Warehouse sources API
    3. Warehouse source groups API
    4. Time series API
      1. List all time series GET
      2. Create a time series POST
      3. Remove a time series DELETE
    5. Embeddings API

List all time series

Returns a paginated list of computed time series for a specific Warehouse source.

GET https://warehouse.betterstack.com/api/v1/sources/{source_id}/time_series

URL parameters

source_id
required string

The ID of the Warehouse source to retrieve time series for.

Query parameters

page
integer

The page number to retrieve. Defaults to 1.

per_page
integer

The number of items per page. Defaults to 50, maximum of 100.

Headers

Authorization
required string

Bearer $TOKEN

200

A paginated list of time series configurations.

Response body

{
  "data": [
    {
      "id": "5215107",
      "type": "time_series",
      "attributes": {
        "name": "level",
        "sql_expression": "JSONExtract(raw, 'level', 'Nullable(String)')",
        "aggregations": [],
        "type": "string_low_cardinality",
        "expression_index": null
      }
    }
  ],
  "pagination": {
    "first": "https://warehouse.betterstack.com/api/v1/sources/12345/time_series?page=1",
    "last": "https://warehouse.betterstack.com/api/v1/sources/12345/time_series?page=1",
    "prev": null,
    "next": null
  }
}
401

Unauthorized

Response body

{
  "errors": "Invalid authentication"
}
404

Not Found

Response body

{
  "errors": "Source with the provided ID was not found"
}

Example cURL

Example
curl --request GET \
  --url https://warehouse.betterstack.com/api/v1/sources/12345/time_series \
  --header "Authorization: Bearer $TOKEN"

Previous article

List sources in a warehouse source group

Next article

Create a time series