List Database Instances

Returns a list of instances of a database. Instances are the individual primary or replica databases in each region defined by the group.

GET /v1/organizations/{organizationSlug}/databases/{databaseName}/instances

cURL

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

200

{
  "instances": [
    {
      "uuid": "0be90471-6906-11ee-8553-eaa7715aeaf2",
      "name": "aws-us-east-1",
      "type": "primary",
      "region": "aws-us-east-1",
      "hostname": "[databaseName]-[organizationSlug].turso.io"
    }
  ]
}

cURL

curl -L https://api.turso.tech/v1/organizations/{organizationSlug}/databases/{databaseName}/instances \
  -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

200 - application/json

Successful response

instances · object[]

Show child attributes