# List databases (/docs/management-api/endpoints/databases/get-databases)

Location: Management API > Endpoints > Databases > List databases

Returns all databases the token has access to. Optionally filter by project ID.

## API reference

### List databases

`GET /v1/databases`

Returns all databases the token has access to. Optionally filter by project ID.

#### Parameters

- `cursor` (query, string | null, optional): Cursor for pagination
- `limit` (query, number, optional): Limit for pagination
- `projectId` (query, string, optional): Filter databases by project ID
- `branchId` (query, optional)
- `branchGitName` (query, string, optional)

#### Responses

- `200`: Returns the list of databases.
- `401`: Missing or invalid authorization token.
- `403`: Actor does not have access to the requested databases.

## Related pages

- [`Create database`](https://www.prisma.io/docs/management-api/endpoints/databases/post-databases): Creates a new database in the specified project.
- [`Create database`](https://www.prisma.io/docs/management-api/endpoints/databases/post-projects-by-project-id-databases): Creates a new database for the given project.
- [`Delete database`](https://www.prisma.io/docs/management-api/endpoints/databases/delete-databases-by-database-id): Deletes the database with the given ID.
- [`Get database`](https://www.prisma.io/docs/management-api/endpoints/databases/get-databases-by-database-id): Returns the database with the given ID.
- [`Get list of databases`](https://www.prisma.io/docs/management-api/endpoints/databases/get-projects-by-project-id-databases): Returns databases for the given project.