List Databases
Returns a list of databases belonging to the organization or user.
curl -L https://api.turso.tech/v1/organizations/{organizationSlug}/databases \
-H 'Authorization: Bearer TOKEN'
{
"databases": [
{
"Name": "my-db",
"DbId": "0eb771dd-6906-11ee-8553-eaa7715aeaf2",
"Hostname": "[databaseName]-[organizationSlug].turso.io",
"block_reads": false,
"block_writes": false,
"allow_attach": false,
"regions": [
"lhr",
"bos",
"nrt"
],
"primaryRegion": "lhr",
"type": "logical",
"version": "0.22.22",
"group": "default",
"is_schema": false,
"schema": "",
"archived": false
}
]
}
curl -L https://api.turso.tech/v1/organizations/{organizationSlug}/databases \
-H 'Authorization: Bearer TOKEN'
Path Parameters
The slug of the organization or user account.
Query Parameters
Filter databases by group name.
The schema database name that can be used to get databases that belong to that parent schema.
Response
The database name, unique across your organization.
The database universal unique identifier (UUID).
The DNS hostname used for client libSQL and HTTP connections.
The current status for blocked reads.
The current status for blocked writes.
The current status for allowing the database to be attached to another.
A list of regions for the group the database belongs to.
The primary region location code the group the database belongs to.
The string representing the object type.
The current libSQL version the database is running.
The name of the group the database belongs to.
If this database controls other child databases then this will be true
. See Multi-DB Schemas.
The name of the parent database that owns the schema for this database. See Multi-DB Schemas.
The current status of the database. If true
, the database is archived and requires a manual unarchive step.
Was this page helpful?
curl -L https://api.turso.tech/v1/organizations/{organizationSlug}/databases \
-H 'Authorization: Bearer TOKEN'
{
"databases": [
{
"Name": "my-db",
"DbId": "0eb771dd-6906-11ee-8553-eaa7715aeaf2",
"Hostname": "[databaseName]-[organizationSlug].turso.io",
"block_reads": false,
"block_writes": false,
"allow_attach": false,
"regions": [
"lhr",
"bos",
"nrt"
],
"primaryRegion": "lhr",
"type": "logical",
"version": "0.22.22",
"group": "default",
"is_schema": false,
"schema": "",
"archived": false
}
]
}