---
title: "GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases"
method: GET
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases"
---

# GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases

`GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases`

Lists the SQL databases under an existing Azure Cosmos DB database account.

## Path parameters

- `resourceGroupName` string, required
- `accountName` string, required

## Query parameters

- `api-version` string, required

## Parameters

- `../../../../../common-types/resource-management/v1/types.json#/components/parameters/SubscriptionIdParameter` — unresolved $ref

## Response `200`

The SQL database properties were retrieved successfully.

- SqlDatabaseListResult — The List operation response, that contains the SQL databases and their properties.
  - `value` SqlDatabaseGetResults[] — List of SQL databases and their properties.
    - `id` string — The unique resource identifier of the ARM resource.
    - `name` string — The name of the ARM resource.
    - `type` string — The type of Azure resource.
    - `location` string — The location of the resource group to which the resource belongs.
    - `tags` Tags — Tags are a list of key-value pairs that describe the resource. These tags can be used in viewing and grouping this resource (across resource groups). A maximum of 15 tags can be provided for a resource. Each tag must have a key no greater than 128 characters and value no greater than 256 characters. For example, the default experience for a template type is set with "defaultExperience": "Cassandra". Current "defaultExperience" values also include "Table", "Graph", "DocumentDB", and "MongoDB".

## Changes

- **2020-11-05** (2019-08-01) `33b0524b6a01` — 1 warning
  - deleted the `path` request parameter `subscriptionId`

[Change history](https://skmtc.dev/azure/apis/cosmos-db/changes/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/:accountName/sqlDatabases/get.md)

---

[API](https://skmtc.dev/azure/apis/cosmos-db.md) · [All operations](https://skmtc.dev/azure/apis/cosmos-db/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/cosmos-db/revisions/33b0524b6a01/schema)