---
title: "(BETA) List AI Lake Database instances"
method: GET
path: "/api/v1/ailake/database/instances"
tags: ["AI Lake - Databases"]
---

# (BETA) List AI Lake Database instances

`GET /api/v1/ailake/database/instances`

## Request

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

(BETA) Lists database instances in the organization's AI Lake.

## Query parameters

- `page` integer: Zero-based page number.
- `size` integer: Number of items per page.
- `metaInclude` string[]

## Response `200`

AI Lake database instances successfully retrieved

- JsonApiListDocumentDatabaseInstance: JSON:API-compatible list response envelope
  - `data` JsonApiItemDatabaseInstance[], required: Array of resource items
    - `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
  - `meta` JsonApiListMeta: Metadata for a paginated list response
    - `page` JsonApiPageInfo, required: Pagination information
      - `number` integer, required: Zero-based page number
      - `size` integer, required: Page size
      - `totalElements` integer: Total number of elements; only present when metaInclude=page was requested
      - `totalPages` integer: Total number of pages; only present when metaInclude=page was requested

---

[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)