---
title: "Organization Usage"
method: GET
path: "/v1/organizations/{organizationSlug}/usage"
---

# Organization Usage

`GET /v1/organizations/{organizationSlug}/usage`

Fetch current billing cycle usage for an organization.

## Path parameters

- `organizationSlug` string, required

## Response `200`

Successful response

- object
  - `organization` object — The organization usage object, containing the total usage for rows read and written, as well as the total storage size (in bytes).
    - `uuid` string — The UUID of the organization.
    - `usage` object — The usage object for the organization.
      - `rows_read` integer — The number of rows read allowed for the specific plan.
      - `rows_written` integer — The number of rows written allowed for the specific plan.
      - `databases` integer — The number of databases allowed for the specific plan.
      - `locations` integer — The number of locations allowed for the specific plan.
      - `storage_bytes` integer — The amount of storage allowed for the specific plan, in bytes.
      - `groups` integer — The number of groups allowed for the specific plan.
      - `bytes_synced` integer — The number of bytes synced allowed for the specific plan, in bytes.
    - `databases` DatabaseUsageOutput[] — The databases for the organization and their usage.
      - `uuid` DbId — unresolved $ref
      - `instances` object[] — The usage objects for instances of the current database.
        - `uuid` string — The instance universal unique identifier (UUID).
        - `usage` DatabaseUsageObject
          - `rows_read` integer — The total rows read in the time period.
          - `rows_written` integer — The total rows written in the time period.
          - `storage_bytes` integer — The total storage used.
          - `bytes_synced` integer — The total bytes synced.
      - `total` DatabaseUsageObject
        - `rows_read` integer — The total rows read in the time period.
        - `rows_written` integer — The total rows written in the time period.
        - `storage_bytes` integer — The total storage used.
        - `bytes_synced` integer — The total bytes synced.

---

[API](https://skmtc.net/turso/apis/turso-platform-api.md) · [All operations](https://skmtc.net/turso/apis/turso-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/turso/turso-platform-api/revisions/6c99e4c88978/schema)