---
title: "(BETA) Get the specified AILake Database instance"
method: GET
path: "/api/v1/ailake/database/instances/{instanceId}"
tags: ["AI Lake - Databases"]
---

# (BETA) Get the specified AILake Database instance

`GET /api/v1/ailake/database/instances/{instanceId}`

## Request

- Base URL: `https://www.gooddata.ai`
- URL: `https://www.gooddata.ai/api/v1/ailake/database/instances/{instanceId}`
- Auth: none declared

(BETA) Retrieve details of the specified AI Lake database instance in the organization's AI Lake.

## Path parameters

- `instanceId` string, required: Database instance identifier. Accepts the database name (preferred) or UUID.

## Response `200`

AI Lake database instance successfully retrieved

- JsonApiDocumentDatabaseInstance: JSON:API-compatible single-resource response envelope
  - `data` JsonApiItemDatabaseInstance, required: A single JSON:API resource item
    - `attributes` DatabaseInstance, required: A single AI Lake Database instance
      - `dataSources` DataSourceInfo[], required: All data source associations for this database instance.
        - `dataSourceId` string, required: Identifier of the data source in metadata-api.
        - `dataSourceName` string, required: Display name of the data source in metadata-api.
        - `id` string, required: Id of the data source association record.
      - `id` string, required: Id of the AI Lake Database instance
      - `name` string, required: Name of the AI Lake Database instance
      - `storageIds` string[], required: Set of names of the storage instances this database instance accesses. Kept for backward compatibility; use `storages` for the storage ids.
      - `storages` ObjectStorageRef[], required: Storage instances this database instance accesses.
        - `name` string, required: Human-readable name of the storage.
        - `storageId` string, required: Stable identifier of the storage, as returned by the ObjectStorages listing.
    - `id` string, required: Resource identifier
    - `type` string, required: Resource type
  - `links` JsonApiListLinks, required: Links object for a list response
    - `self` string, required: The URL of this response

---

[API](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/revisions/c728ef303bfb?raw)