---
title: "GET /billing/usage"
method: GET
path: "/billing/usage"
---

# GET /billing/usage

`GET /billing/usage`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/billing/usage`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Response `200`

OK

- object: Usage metrics for a specific billing period
  - `period` string, required: Billing period, identified by its start date (YYYY-MM-DD). Periods follow the org's billing anchor day, not the calendar month. Legacy periods recorded before anchored billing use YYYY-MM.
  - `usage` object, required: Breakdown of resource usage by category
    - `message_sent` integer, required: Total email messages sent during the period
    - `message_received` integer, required: Total email messages received during the period
    - `sms_sent` integer, required: Total SMS messages sent during the period
    - `sms_received` integer, required: Total SMS messages received during the period
    - `call_minute` integer, required: Total voice call minutes consumed during the period
    - `voice_credit` integer, required: Voice credits drawn from the plan allowance this period. 1 credit = 1 US minute; mobile-abroad minutes draw more. This — not call_minute — is what the included voice allowance is measured in.
    - `embedding_generated` integer, required: Total embeddings generated during the period
  - `storage` object, nullable, required: Last measured object-storage usage; null when never measured
    - `bytes` integer, required: Bytes held in object storage
    - `measuredAt` string, required: ISO timestamp of the measurement

---

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