---
title: "Read account usage time-series buckets for visible meters"
method: GET
path: "/account/usage/timeseries"
---

# Read account usage time-series buckets for visible meters

`GET /account/usage/timeseries`

## Request

- Base URL: `https://api.eurobase.dev`
- URL: `https://api.eurobase.dev/account/usage/timeseries`
- Auth: HTTP bearer

## Query parameters

- `organizationId` string
- `metricCodes` string, required
- `range` '24h' | '7d' | '30d' | '90d'
- `bucket` '1h' | '1d'

## Response `200`

Account usage time-series buckets

- AccountUsageTimeSeriesResponse
  - `range` '24h' | '7d' | '30d' | '90d', required
  - `bucket` '1h' | '1d', required
  - `window` object, required
    - `start` string, date-time, required
    - `end` string, date-time, required
  - `series` AccountUsageTimeSeries[], required
    - `metricCode` string, required
    - `unit` string, required
    - `status` 'available' | 'empty' | 'unavailable' | 'unsupported', required
    - `points` AccountUsageTimeSeriesPoint[], required
      - `start` string, date-time, required
      - `end` string, date-time, required
      - `value` string, nullable, required
      - `state` 'available' | 'empty' | 'unavailable', required
      - `final` boolean, required
  - `generatedAt` string, date-time, required

## Other responses

- `400`: Invalid or duplicate metric, range, or bucket
- `404`: Organization not found

---

[API](https://skmtc.dev/eurobase/apis/eurobase-api.md) · [All operations](https://skmtc.dev/eurobase/apis/eurobase-api/llms.txt) · [OpenAPI document](https://skmtc.dev/eurobase/apis/eurobase-api/revisions/5266a299d18a?raw)