curl -L 'https://api.turso.tech/v1/organizations/{organizationSlug}/databases/{databaseName}' \
-H 'Authorization: Bearer TOKEN'
import { createClient } from "@tursodatabase/api";
const turso = createClient({
org: "...",
token: "",
});
const database = await turso.databases.retrieve("my-db");
{
"database": {
"Name": "my-db",
"DbId": "0eb771dd-6906-11ee-8553-eaa7715aeaf2",
"Hostname": "[databaseName]-[organizationSlug].turso.io",
"block_reads": false,
"block_writes": false,
"regions": [
"aws-us-east-1"
],
"primaryRegion": "aws-us-east-1",
"group": "default",
"delete_protection": false,
"parent": {
"id": "<string>",
"name": "<string>",
"branched_at": "2025-04-15T13:14:34.468213117Z"
}
}
}{
"error": "could not find database with name [databaseName]: record not found"
}Databases
Retrieve Database
Returns a database belonging to the organization or user.
GET
/
v1
/
organizations
/
{organizationSlug}
/
databases
/
{databaseName}
curl -L 'https://api.turso.tech/v1/organizations/{organizationSlug}/databases/{databaseName}' \
-H 'Authorization: Bearer TOKEN'
import { createClient } from "@tursodatabase/api";
const turso = createClient({
org: "...",
token: "",
});
const database = await turso.databases.retrieve("my-db");
{
"database": {
"Name": "my-db",
"DbId": "0eb771dd-6906-11ee-8553-eaa7715aeaf2",
"Hostname": "[databaseName]-[organizationSlug].turso.io",
"block_reads": false,
"block_writes": false,
"regions": [
"aws-us-east-1"
],
"primaryRegion": "aws-us-east-1",
"group": "default",
"delete_protection": false,
"parent": {
"id": "<string>",
"name": "<string>",
"branched_at": "2025-04-15T13:14:34.468213117Z"
}
}
}{
"error": "could not find database with name [databaseName]: record not found"
}curl -L 'https://api.turso.tech/v1/organizations/{organizationSlug}/databases/{databaseName}' \
-H 'Authorization: Bearer TOKEN'
import { createClient } from "@tursodatabase/api";
const turso = createClient({
org: "...",
token: "",
});
const database = await turso.databases.retrieve("my-db");
Authorizations
Path Parameters
Was this page helpful?