# Get database usage metrics (/docs/rest-api/endpoints/database-usage/get-databases-by-database-id-usage)

> For the complete Prisma documentation index, see [llms.txt](https://www.prisma.io/docs/llms.txt). A markdown version of any docs page is available by appending `.md` to its URL.

Returns usage metrics for the specified database.

Location: REST API > Endpoints > Database Usage > Get database usage metrics

Returns usage metrics for the specified database.

## API reference

### Get database usage metrics

`GET /v1/databases/{databaseId}/usage`

Returns usage metrics for the specified database.

#### Parameters

- `databaseId` (path, string, required)
- `startDate` (query, string, optional): Start date for metrics query. Defaults to start of current month if not provided.
- `endDate` (query, string, optional): End date for metrics query. Will be set to end of day if a future date is provided. Defaults to current date if not provided.

#### Responses

- `200`: Returned usage metrics for the given database.
- `400`: Invalid request parameters
- `401`: Missing or invalid authorization token.
- `404`: Database with the given ID was not found.
- `500`: Error occurred while fetching metrics
- `503`: Usage metrics are temporarily unavailable