---
title: "Own org balance, quota and credit ledger"
method: GET
path: "/v1/usage"
tags: ["Account"]
---

# Own org balance, quota and credit ledger

`GET /v1/usage`

## Request

- Base URL: `https://api.temsor.com`
- URL: `https://api.temsor.com/v1/usage`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Requires an API key. `org_id` comes only from the key — query parameters cannot override the tenant.

## Response `200`

Success

- object
  - `org` string, required
  - `plan` string, required
  - `org_plan` string, required
  - `balance` integer, nullable, required
  - `quota` object, required
    - `used` integer, required
    - `limit` integer, nullable, required
  - `alert_level` integer, required
  - `ledger` object[], required
  - `balance_active` boolean, required

## Other responses

- `400`: Error
- `401`: Error
- `403`: Error

---

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