---
title: "List"
method: GET
path: "/v2/databases"
tags: ["Database (v2)"]
---

# List

`GET /v2/databases`

## Request

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

List database the user has access to.

## Query parameters

- `search` string, nullable: Search over the group name
- `page` integer, required
- `per_page` integer: Items per page. Defaults to 50; `0` is rejected.

## Response `200`

- ListDatabaseV2Response
  - `databases` Database2[], required
    - `name` string, required: Name of the [Database]
    - `id` string, required: [DatabaseId] is a `db_<ulid>`
    - `url` string, uri, required: Url of the database
    - `block_reads` boolean, required: The status for reads from your database
    - `block_writes` boolean, required: The status for writes from your database
    - `size_max` string, required: The current size limit of the Database
    - `current_size` string, required: The current size Database
    - `size_max_bytes` integer, required: The current size limit of the Database in bytes
    - `current_size_bytes` integer, required: The current size Database in bytes
    - `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 Replica Regions are the regions where your replicas will be able to be commissionned.
  - `page_info` DatabaseV2PageInfo, required
    - `current_page` integer, required
    - `total_items` integer, required
    - `has_more_items` boolean, required

## Other responses

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

## Changes

- **2026-11-12** `f3bb69bad6b6`: 3 breaking, 2 info
  - for the `query` request parameter `per_page`, default value was changed from `0` to `50`
  - for the `query` request parameter `per_page`, the min was increased from `0.00` to `1.00`
  - for the `query` request parameter `per_page`, the format changed from `uint` to `uint32`
  - added the non-success response with the status `400`
  - …1 more
- **2026-04-26** `2a6107525e2a`: 4 info
  - response property `databases/items/current_size` deprecated
  - response property `databases/items/size_max` deprecated
  - added the required property `databases/items/current_size_bytes` to the response with the `200` status
  - added the required property `databases/items/size_max_bytes` to the response with the `200` status

[Operation history](https://skmtc.dev/bunny/apis/bunny-database-backend-api/changes/v2/databases/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)