---
title: "List"
method: GET
path: "/v1/groups"
tags: ["DatabaseGroup"]
---

# List

`GET /v1/groups`

## Request

- Base URL: `https://api.bunny.net/database`
- URL: `https://api.bunny.net/database/v1/groups`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `AccessKey`

List database groups the user has access to.

## Query parameters

- `search` string, nullable: Search over the group name

## Response `200`

- ListDatabaseGroupResponse
  - `groups` DatabaseGroup[], required: Array of [DatabaseGroup]
    - `id` string, required: [DatabaseGroupId] is a `group_<ulid>`
    - `name` string, required: The [DatabaseGroup] name, unique across your account.
    - `storage_region` string, required: The current Storage Region used to store your databases.
    - `primary_regions` PossibleRegion[], required: The Primary Regions available for your Database, when your database need to be commissionned, it'll be comissionned in one of those regions.
    - `replicas_regions` PossibleRegion[], required: The Secondary Regions are the regions where your replicas will be able to be commissionned.

## Other responses

- `401`: A default error response for most API errors.
- `500`: A default error response for most API errors.

---

[API](https://skmtc.dev/bunny/apis/bunny-database-backend-api.md) - [All operations](https://skmtc.dev/bunny/apis/bunny-database-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bunny/apis/bunny-database-backend-api/revisions/f3bb69bad6b6?raw)