Retrieve Database

curl -L 'https://api.turso.tech/v1/organizations/{organizationSlug}/databases/{databaseName}' \
-H 'Authorization: Bearer TOKEN'

{
  "database": {
    "Name": "my-db",
    "DbId": "0eb771dd-6906-11ee-8553-eaa7715aeaf2",
    "Hostname": "[databaseName]-[organizationSlug].turso.io",
    "block_reads": false,
    "block_writes": false,
    "regions": [
      "lhr",
      "bos",
      "nrt"
    ],
    "primaryRegion": "lhr",
    "group": "default",
    "delete_protection": false,
    "parent": {
      "id": "<string>",
      "name": "<string>",
      "branched_at": "2025-04-15T13:14:34.468213117Z"
    }
  }
}

GET

organizations

{organizationSlug}

databases

{databaseName}

curl -L 'https://api.turso.tech/v1/organizations/{organizationSlug}/databases/{databaseName}' \
-H 'Authorization: Bearer TOKEN'

{
  "database": {
    "Name": "my-db",
    "DbId": "0eb771dd-6906-11ee-8553-eaa7715aeaf2",
    "Hostname": "[databaseName]-[organizationSlug].turso.io",
    "block_reads": false,
    "block_writes": false,
    "regions": [
      "lhr",
      "bos",
      "nrt"
    ],
    "primaryRegion": "lhr",
    "group": "default",
    "delete_protection": false,
    "parent": {
      "id": "<string>",
      "name": "<string>",
      "branched_at": "2025-04-15T13:14:34.468213117Z"
    }
  }
}

curl -L 'https://api.turso.tech/v1/organizations/{organizationSlug}/databases/{databaseName}' \
-H 'Authorization: Bearer TOKEN'

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

organizationSlug

string

required

The slug of the organization or user account.

databaseName

string

required

The name of the database.

Response

Successful response

database

object

Show child attributes

database.Name

string

The database name, unique across your organization.

Example:

"my-db"

database.DbId

string

The database universal unique identifier (UUID).

Example:

"0eb771dd-6906-11ee-8553-eaa7715aeaf2"

database.Hostname

string

The DNS hostname used for client libSQL and HTTP connections.

Example:

"[databaseName]-[organizationSlug].turso.io"

database.block_reads

boolean

The current status for blocked reads.

Example:

false

database.block_writes

boolean

The current status for blocked writes.

Example:

false

database.regions

string[]

deprecated

A list of regions for the group the database belongs to.

Example:

["lhr", "bos", "nrt"]

database.primaryRegion

string

The primary region location code the group the database belongs to.

Example:

"lhr"

database.group

string

The name of the group the database belongs to.

Example:

"default"

database.delete_protection

boolean

The current status for delete protection. If enabled, the database cannot be deleted.

Example:

false

database.parent

object

Show child attributes

database.parent.id

string

The parent database identifier.

database.parent.name

string

The name of the parent database.

database.parent.branched_at

string<date-time>

The timestamp when the database was branched from the parent.

Example:

"2025-04-15T13:14:34.468213117Z"

Create Retrieve Configuration

⌘I

Turso Cloud

SDKs

CLI

API Reference

Retrieve Database

Authorizations

Path Parameters

Response