---
title: "Retrieve Database Usage"
method: GET
path: "/v1/organizations/{organizationSlug}/databases/{databaseName}/usage"
---

# Retrieve Database Usage

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

Fetch activity usage for a database in a given time period.

## Path parameters

- `organizationSlug` string, required
- `databaseName` string, required

## Query parameters

- `from` string, date-time
- `to` string, date-time

## Response `200`

Successful response

- object
  - `database` DatabaseUsageOutput
    - `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.

## Other responses

- `400` — Bad Request
- `404` — Database not found

---

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