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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The slug of the organization or user account.
The name of the database.
Response
Successful response
Show child attributes
Show child attributes
Was this page helpful?