Skip to main content
GET
/
v1
/
organizations
/
{organizationSlug}
/
usage
curl -L https://api.turso.tech/v1/organizations/{organizationSlug}/usage \
  -H 'Authorization: Bearer TOKEN'

{
  "organization": {
    "uuid": "fa72ba58-7db3-436b-bcab-14b83eb1dd88",
    "usage": {
      "rows_read": 1000000000,
      "rows_written": 25000000,
      "databases": 500,
      "locations": 3,
      "storage_bytes": 9000000000,
      "groups": 1,
      "bytes_synced": 3000000000
    },
    "databases": [
      {
        "uuid": "<unknown>",
        "instances": [
          {
            "uuid": "cd831986-94e5-11ee-a6fe-7a52e1f7759a",
            "usage": {
              "rows_read": 0,
              "rows_written": 0,
              "storage_bytes": 4096,
              "bytes_synced": 0
            }
          },
          {
            "uuid": "0be90471-6906-11ee-8553-eaa7715aeaf2",
            "usage": {
              "rows_read": 0,
              "rows_written": 0,
              "storage_bytes": 4096,
              "bytes_synced": 0
            }
          }
        ],
        "total": {
          "rows_read": 0,
          "rows_written": 0,
          "storage_bytes": 8192,
          "bytes_synced": 0
        }
      }
    ]
  }
}
curl -L https://api.turso.tech/v1/organizations/{organizationSlug}/usage \
  -H 'Authorization: Bearer TOKEN'

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
organizationSlug
string
required

The slug of the organization or user account.

Response

200 - application/json

Successful response

​
organization
object

The organization usage object, containing the total usage for rows read and written, as well as the total storage size (in bytes).