---
title: "Get daily-usage table (JSON or CSV)"
method: GET
path: "/v1/billing/daily-table"
tags: ["Billing"]
---

# Get daily-usage table (JSON or CSV)

`GET /v1/billing/daily-table`

## Request

- Base URL: `https://docs.grepr.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.grepr.ai/v1/billing/daily-table`
- Auth: OpenID Connect (`https://grepr-prod.us.auth0.com/.well-known/openid-configuration`)

Returns the daily-usage table for the requested reporting period.

## Query parameters

- `period` string

## Response `200`

Daily-usage table.

- DailyTable: Daily-usage table.
  - `current` boolean: True when the reporting period contains today. Same semantic as PeriodEntry.current — the last entry of days[] represents an incomplete day, so consumers should mark it as in-progress.
  - `days` string[], required: The reporting period's days in ascending order.
  - `metrics` MeteredDimensionUsage[], required: One usage series per metered dimension, in display order. Bricks absent from the configured displayed-brick list are skipped.
    - `dailyValues` number[], required: Per-day usage counts.
    - `label` string, required: Display label for the metered dimension.
    - `previousMonthTotal` number: This column's total for the prior calendar month; null when no prior-month comparison applies (a partial billing cycle, or no prior month before the contract start). Consumers derive the delta and percent change from this value and {@link #getTotal()}.
    - `total` number, required: Sum of the daily values over the reporting period.
    - `totalDollars` number: Billed dollar amount for the period; null when this column has no unit price.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/grepr/apis/grepr-api.md) - [All operations](https://skmtc.dev/grepr/apis/grepr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/grepr/apis/grepr-api/revisions/2a5ce03a0bf0?raw)