---
title: "Usage data"
method: GET
path: "/usage"
---

# Usage data

`GET /usage`

Generate an hourly consumption report.

## Query parameters

- `from` string, date-time, required
- `to` string, date-time, required
- `email` string[]
- `service` Service[]
- `by` 'hour' | 'day (planned)' | 'total'

## Response `200`

The hourly report.

- object[]
  - `email` string, email, required — The email address of the user whose data is selected.
  - `from` string, date-time, required — The ISO datetime of the first datapoint.
  - `to` string, date-time, required — The ISO datetime of the last datapoint.
  - `service` 'search' | 'browser', required
  - `result` 'success' | 'failure', required — The type of result included in the data.
  - `calls` integer, required — The number of API calls of the service and result type.
  - `credits` integer, required — The number of credits consumed by the API calls.
  - `meanSecs` number, required — The average number of elapsed seconds of the API calls.

## Other responses

- `401` — The authorization header was missing.
- `403` — The API token was invalid.
- `422` — One or more parameters were invalid.
- `429` — The rate limit was exceeded.
- `500` — An unknown error occurred.

## Changes

- **2026-06-29** `bbfea328162f` — 1 info
  - added the required property `items/credits` to the response with the `200` status

[Change history](https://skmtc.dev/joinmassive/apis/massive/changes/usage/get.md)

---

[API](https://skmtc.dev/joinmassive/apis/massive.md) · [All operations](https://skmtc.dev/joinmassive/apis/massive/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/joinmassive/massive/revisions/3a9f7769563f/schema)