---
title: "Get summarised metrics for a content item."
method: GET
path: "/metrics/{base_path}"
tags: ["Aggregations"]
---

# Get summarised metrics for a content item.

`GET /metrics/{base_path}`

## Request

- Base URL: `https://content-data-api.publishing.service.gov.uk/api/v1`
- URL: `https://content-data-api.publishing.service.gov.uk/api/v1/metrics/{base_path}`
- Auth: HTTP bearer

Returns a summary of a metric based on data collected over a time period.

## Path parameters

- `base_path` string, required
- `metrics` string, required

## Query parameters

- `from` string, required
- `to` string, required

## Response `200`

Success response

- SummaryResponse: Summary information keyed by metric ID.

## Other responses

- `400`: The API request is invalid.

## Changes

- **2018-09-12** `db80c4ca0476`: 2 info
  - for the `query` request parameter `from`, the type was generalized from `date` to `string`
  - for the `query` request parameter `to`, the type was generalized from `date` to `string`
- **2018-09-07** `526b660a1342`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/government-digital-service/apis/gov-uk-content-data-api/changes/metrics/:base_path/get.md)

---

[API](https://skmtc.dev/government-digital-service/apis/gov-uk-content-data-api.md) - [All operations](https://skmtc.dev/government-digital-service/apis/gov-uk-content-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/government-digital-service/apis/gov-uk-content-data-api/revisions/856c07d21d1b?raw)
