---
title: "GET /orgs/me/usage"
method: GET
path: "/orgs/me/usage"
---

# GET /orgs/me/usage

`GET /orgs/me/usage`

## Request

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

## Query parameters

- `period` string: Billing period in YYYY-MM format (e.g. '2026-05'). Defaults to the current month in UTC.

## Response `200`

OK

- object: Usage rollup for an organization's billing period
  - `period` string, required: Billing period the rollup covers (YYYY-MM).
  - `updatedAt` string, date-time, nullable, required: Latest update timestamp across all returned counters. null if no usage has been recorded yet.
  - `totals` object, required: Counters keyed by usage type (e.g. 'email_sent', 'sms_sent', 'voice_call_minutes'). Missing keys mean zero.

---

[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)