---
title: "Aggregated alias usage statistics"
method: GET
path: "/cdn/statistics/aliases_usage/aggregated"
tags: ["CDN Statistics"]
---

# Aggregated alias usage statistics

`GET /cdn/statistics/aliases_usage/aggregated`

## Request

- Base URL: `https://api.gcore.com`
- URL: `https://api.gcore.com/cdn/statistics/aliases_usage/aggregated`
- Auth: HTTP apikey

Get the number of aliases in use.

Request URL parameters should be added as a query string after the endpoint.

The requested period is always expanded to whole calendar months, so a request for part of a
month returns the count for its entire containing month.

## Query parameters

- `from` string, required
- `to` string, required
- `group_by` string
- `resource` integer
- `flat` boolean

## Response `200`

Successful.

- GetAliasUsageAggregatedStat
  - `resource` object: Resources IDs by which statistics data is grouped.
  - `1 (example)` object: CDN resource ID for which statistics data is shown.
  - `client` object: Client IDs by which statistics data is grouped.
  - `12 (example)` object: Client ID for which statistics data is shown.
  - `metrics` object: Statistics parameters.
    - `alias_usage` integer: Number of aliases in use.

## Other responses

- `204`: There is no data for the requested time period.

## Changes

- **2026-09-28** `9b685d687b49`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/g-core/apis/gcore-openapi/changes/cdn/statistics/aliases_usage/aggregated/get.md)

---

[API](https://skmtc.dev/g-core/apis/gcore-openapi.md) - [All operations](https://skmtc.dev/g-core/apis/gcore-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/g-core/apis/gcore-openapi/revisions/a2b772345f3a?raw)