Path Parameters
The slug of the organization or user account.
Response
200 - application/json
Successful response
The organization usage object, containing the total usage for rows read and written, as well as the total storage size (in bytes).
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
}
}
]
}
}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'
The slug of the organization or user account.
Successful response
The organization usage object, containing the total usage for rows read and written, as well as the total storage size (in bytes).
Show child attributes
Was this page helpful?