---
title: "Get organization usage"
method: GET
path: "/v1/usage"
tags: ["Usage"]
---

# Get organization usage

`GET /v1/usage`

## Request

- Base URL: `https://hcti.io`
- URL: `https://hcti.io/v1/usage`
- Auth: HTTP basic

Returns usage information for the authenticated organization, including image totals by billing period.

## Query parameters

- `skipCache` boolean

## Response `200`

OK

- UsageDataReturn: Image usage for the authenticated organization, grouped by calendar intervals and billing periods.
  - `data` UsageTimeSeries: Image counts grouped by hour, calendar day, and calendar month. Each object maps an interval's start timestamp to its image count. Intervals without recorded data may be omitted.
    - `hour` object: Hourly image counts, with up to 72 recent entries. Keys are ISO 8601 timestamps identifying the start of each hour; values are image counts for that hour.
    - `day` object: Daily image counts, with up to 60 recent entries. Keys are ISO 8601 timestamps identifying the start of each calendar day; values are image counts for that day.
    - `month` object: Monthly image counts, with up to 12 recent entries. Keys are ISO 8601 timestamps identifying the start of each calendar month; values are image counts for that month. Calendar months are separate from billing periods.
  - `per_billing_period` PerBillingPeriodCounter[]: Image totals for available billing periods, ordered by period start from oldest to newest. Billing periods follow the organization's billing schedule rather than calendar months.
    - `total_images` union: Number of images counted in this billing period. For a period still in progress, this is the usage recorded so far.
      - integer
      - string, int32
    - `start` string, date-time: Start of the billing period, as an ISO 8601 UTC timestamp.
    - `end` string, date-time, nullable: End of the billing period, as an ISO 8601 UTC timestamp, when available. A future timestamp indicates a period that has not yet ended.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

## Changes

- **2026-09-14** `d5730c2a58f6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/htmlcsstoimage/apis/html-css-to-image-api/changes/v1/usage/get.md)

---

[API](https://skmtc.dev/htmlcsstoimage/apis/html-css-to-image-api.md) - [All operations](https://skmtc.dev/htmlcsstoimage/apis/html-css-to-image-api/llms.txt) - [OpenAPI document](https://skmtc.dev/htmlcsstoimage/apis/html-css-to-image-api/revisions/100550373ae1?raw)