---
title: "Returns the hourly and daily consumption breakdown for the authenticated token within a date range"
method: POST
path: "/tokens/consumption"
tags: ["Exato - Consumo"]
---

# Returns the hourly and daily consumption breakdown for the authenticated token within a date range

`POST /tokens/consumption`

Returns the hourly and daily consumption breakdown for the authenticated token within a date range

## Query parameters

- `test_mode` boolean
- `lightweight` boolean

## Response `200`

Success

- TokenConsumptionResponse — TokenConsumptionResponse
  - `result` TokenConsumptionResult — TokenConsumptionResult
    - `token_name` string
    - `from` string, date-time
    - `to` string, date-time
    - `expires_at` string, date-time
    - `expired` boolean
    - `total_transactions` integer
    - `total_credits` integer
    - `total_currency` number, double
    - `hourly_breakdown` TokenConsumptionHourlyEntry[]
      - `timestamp` string, date-time
      - `transactions` integer
      - `credits` integer
      - `currency` number, double
    - `daily_breakdown` TokenConsumptionDailyEntry[]
      - `date` string, date-time
      - `transactions` integer
      - `credits` integer
      - `currency` number, double
    - `limits` TokenConsumptionLimits — TokenConsumptionLimits
      - `transactions_per_hour` integer
      - `transactions_per_day` integer
      - `transactions_per_week` integer
      - `transactions_per_month` integer
      - `credits_per_hour` integer
      - `credits_per_day` integer
      - `credits_per_week` integer
      - `credits_per_month` integer
    - `usage` TokenConsumptionUsage — TokenConsumptionUsage
      - `current_hour` TokenConsumptionUsageWindow — TokenConsumptionUsageWindow
        - `transactions` integer
        - `limit` integer
        - `percentage` number, double
        - `near_limit` boolean
        - `exceeded` boolean
      - `current_day` TokenConsumptionUsageWindow — TokenConsumptionUsageWindow
        - `transactions` integer
        - `limit` integer
        - `percentage` number, double
        - `near_limit` boolean
        - `exceeded` boolean

---

[API](https://skmtc.dev/directdigital/apis/backend-apis.md) · [All operations](https://skmtc.dev/directdigital/apis/backend-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/directdigital/backend-apis/revisions/a3305895eccd/schema)