---
title: "Get usage by day or by check"
method: GET
path: "/usage"
tags: ["account"]
---

# Get usage by day or by check

`GET /usage`

## Request

- Base URL: `https://api.mobilevalidate.com/v1`
- URL: `https://api.mobilevalidate.com/v1/usage`
- Auth: HTTP bearer

Checks, conclusive answers, cached answers, billed units and cost for an inclusive UTC date range (at most 366 days), for the key's mode (live or test). Rows past the retention period are no longer counted.

## Query parameters

- `from` string, date, required
- `to` string, date, required
- `group_by` 'day' | 'service'

## Response `200`

Usage rows.

- object
  - `object` 'usage', required
  - `from` string, date
  - `to` string, date
  - `group_by` 'day' | 'service'
  - `livemode` boolean
  - `data` object[], required
    - `date` string, date
    - `service` string
    - `checks` integer
    - `conclusive` integer
    - `cached` integer
    - `billed_units` integer
    - `cost` Money
      - `amount` string, required: Decimal USD amount.
      - `currency` 'USD', required
  - `total_cost` Money, required
    - `amount` string, required: Decimal USD amount.
    - `currency` 'USD', required

## Other responses

- `default`: Error. Branch on `error.code`; `suggestion` (optional) says how to fix the request. A known path called with the wrong method answers `404 not_found` with an `Allow` header listing the methods it accepts.

---

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