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

{
  "items": [
    {
      "sys": {
        "asset": {
          "sys": {
            "id": "asset_1",
            "linkType": "Asset",
            "type": "Link"
          }
        },
        "id": "asset_1-space_a",
        "space": {
          "sys": {
            "id": "yadj1kx9rmg0",
            "linkType": "Space",
            "type": "Link"
          }
        },
        "type": "AssetBandwidthUsage"
      },
      "usedBandwidth": 4500000
    }
  ],
  "limit": 30,
  "sys": {
    "type": "Array"
  }
}

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.

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