Get detailed asset bandwidth usage

GET

https://api.contentful.com/organizations/:organization_id/usages-detailed/asset_bandwidth

GET

/organizations/:organization_id/usages-detailed/asset_bandwidth

$ curl --include \
>      --request GET \
>      --header 'Authorization: Bearer <cma_token>' \
>      "https://api.contentful.com/organizations/<organization_id>/usages-detailed/asset_bandwidth?date%5Bgte%5D=2025-01-01&date%5Blte%5D=2025-01-31"

200Usage_getUsageAssetBandwidthDetailed_example

1 {
2   "items": [
3     {
4       "sys": {
5         "asset": {
6           "sys": {
7             "id": "asset_1",
8             "linkType": "Asset",
9             "type": "Link"
10           }
11         },
12         "id": "asset_1-space_a",
13         "space": {
14           "sys": {
15             "id": "yadj1kx9rmg0",
16             "linkType": "Space",
17             "type": "Link"
18           }
19         },
20         "type": "AssetBandwidthUsage"
21       },
22       "usedBandwidth": 4500000
23     }
24   ],
25   "limit": 30,
26   "sys": {
27     "type": "Array"
28   }
29 }

Returns the top 30 assets by bandwidth used for an organization over a given date range, ranked descending and grouped by asset and space. This is a fixed-shape leaderboard, not a general-purpose query endpoint — unlike Get aggregated usage, it does not support group, filter, or order parameters, and covers a single metric (asset_bandwidth) only.

granularity is locked to P1D (daily) — there is no monthly option.

date[gte] and date[lte] are both required. The query window must not exceed 31 days and cannot extend into the future. Data is available from January 2026 onward, with a maximum lookback of 12 months.

For organization-wide or space-scoped totals across other metrics, or for a longer date range, use Get aggregated usage instead.

Available to Organization Admins and Organization Owners.

Returns the top 30 assets by bandwidth used for an organization over a given date range, ranked descending and grouped by asset and space. This is a fixed-shape leaderboard, not a general-purpose query endpoint — unlike [Get aggregated usage](/references/content-management-api/usage/get-usage-aggregated), it does not support `group`, `filter`, or `order` parameters, and covers a single metric (`asset_bandwidth`) only. `granularity` is locked to `P1D` (daily) — there is no monthly option. `date[gte]` and `date[lte]` are both required. The query window must not exceed 31 days and cannot extend into the future. Data is available from January 2026 onward, with a maximum lookback of 12 months. For organization-wide or space-scoped totals across other metrics, or for a longer date range, use [Get aggregated usage](/references/content-management-api/usage/get-usage-aggregated) instead. Available to Organization Admins and Organization Owners.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

organization_idstringRequired

Id of organization

Query parameters

date[gte]stringRequiredformat: "date"

Start of the query window (inclusive). Accepts yyyy-mm-dd or full ISO-8601. Window must not exceed 31 days and cannot extend into the future. Cannot be more than 12 months before the current day.

date[lte]stringRequiredformat: "date"

End of the query window (inclusive). Accepts yyyy-mm-dd or full ISO-8601. Window must not exceed 31 days and cannot extend into the future.

granularityenumOptionalDefaults to P1D

Bucket size in ISO-8601 duration format. Only P1D (daily) is supported today. Defaults to P1D.

Allowed values:

Response headers

Content-TypestringOptional

Content-Type

Response

OK - Request successful