Resources
- Databases
- Groups
- Locations
Organizations
- Organizations
- Members
- Invites
- Audit Logs
API Tokens
- API Tokens
Organization Usage
Fetch current billing cycle usage for an organization.
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": "0eb771dd-6906-11ee-8553-eaa7715aeaf2",
"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'
Path Parameters
The slug of the organization or user account.
Response
The organization usage object, containing the total usage for rows read and written, as well as the total storage size (in bytes).
The UUID of the organization.
"fa72ba58-7db3-436b-bcab-14b83eb1dd88"
The usage object for the organization.
The number of rows read allowed for the specific plan.
1000000000
The number of rows written allowed for the specific plan.
25000000
The number of databases allowed for the specific plan.
500
The number of locations allowed for the specific plan.
3
The amount of storage allowed for the specific plan, in bytes.
9000000000
The number of groups allowed for the specific plan.
1
The number of bytes synced allowed for the specific plan, in bytes.
3000000000
The databases for the organization and their usage.
The usage objects for instances of the current database.
The instance universal unique identifier (UUID).
"cd831986-94e5-11ee-a6fe-7a52e1f7759a"
The usage for the current database instance.
The total rows read in the time period.
0
The total rows written in the time period.
0
The total storage used.
0
The total bytes synced.
0
[
{
"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
}
}
]
The total usage for the database.
The total rows read in the time period.
0
The total rows written in the time period.
0
The total storage used.
0
The total bytes synced.
0
Was this page helpful?
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": "0eb771dd-6906-11ee-8553-eaa7715aeaf2",
"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
}
}
]
}
}