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

Location: Management 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