---
title: "Get usage statistics"
method: GET
path: "/usage"
---

# Get usage statistics

`GET /usage`

## Request

- Base URL: `https://eu1.asr.api.speechmatics.com/v2`
- URL: `https://eu1.asr.api.speechmatics.com/v2/usage`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/speechmatics/apis/speechmatics-asr-rest-api/docs/usage/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `since` string, date
- `until` string, date

## Response `200`

OK

- UsageResponse
  - `since` string, date-time, required
  - `until` string, date-time, required
  - `summary` UsageDetails[], required
    - `mode` 'batch', required
    - `type` 'transcription', required
    - `language` string
    - `operating_point` 'standard' | 'enhanced' | 'melia-1'
    - `count` integer, required: Total number of billable jobs in this cycle
    - `duration_hrs` number, float, required: Total duration of billable jobs (in hours) this cycle
  - `details` UsageDetails[], required
    - `mode` 'batch', required
    - `type` 'transcription', required
    - `language` string
    - `operating_point` 'standard' | 'enhanced' | 'melia-1'
    - `count` integer, required: Total number of billable jobs in this cycle
    - `duration_hrs` number, float, required: Total duration of billable jobs (in hours) this cycle

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `429`: Rate Limited
- `500`: Internal Server Error

---

[API](https://skmtc.dev/speechmatics/apis/speechmatics-asr-rest-api.md) - [All operations](https://skmtc.dev/speechmatics/apis/speechmatics-asr-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/speechmatics/apis/speechmatics-asr-rest-api/revisions/32c77b5e2177?raw)