---
title: "Read"
method: GET
path: "/v1/groups/{group_id}"
tags: ["DatabaseGroup"]
---

# Read

`GET /v1/groups/{group_id}`

## Request

- Base URL: `https://api.bunny.net/database`
- URL: `https://api.bunny.net/database/v1/groups/{group_id}`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `AccessKey`
- TypeScript: <https://skmtc.dev/bunny/apis/bunny-database-backend-api/docs/v1/groups/:group_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Read a DatabaseGroup

## Path parameters

- `group_id` string, required: [DatabaseGroupId] is a `group_<ulid>`

## Response `200`

- ReadDatabaseGroupResponse
  - `group` DatabaseGroup, required: [DatabaseGroup] returned by the API
    - `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.
- `404`: A default error response for most API errors.
- `500`: A default error response for most API errors.

## Changes

- **2026-11-12** `f3bb69bad6b6`: 1 info
  - added the non-success response with the status `404`

[Operation history](https://skmtc.dev/bunny/apis/bunny-database-backend-api/changes/v1/groups/:group_id/get.md)

---

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