Get space usage | Documentation

curl -G https://api.contentful.com/organizations/0D9ZC8rLWiw6x5qizZGiRs/space_periodic_usages \
     -H "Authorization: Bearer <token>" \
     --data-urlencode endAt="2020-01-03" \
     --data-urlencode metric="cma,cpa,gql" \
     --data-urlencode order="-usage" \
     --data-urlencode startAt="2020-01-01"

{
  "items": [
    {
      "dateRange": {
        "endAt": "2020-01-03",
        "startAt": "2020-01-01"
      },
      "metric": "cma",
      "sys": {
        "id": "<usage_metric_id>",
        "space": {
          "sys": {
            "id": "yadj1kx9rmg0",
            "linkType": "Space",
            "type": "Link"
          }
        },
        "type": "SpacePeriodicUsage"
      },
      "unitOfMeasure": "apiRequestCount",
      "usage": 100,
      "usagePerDay": {
        "2020-01-01": 30,
        "2020-01-02": 30,
        "2020-01-03": 40
      }
    }
  ],
  "limit": 25,
  "skip": 0,
  "sys": {
    "type": "Array"
  },
  "total": 100
}

Deprecated. Sunset: 2027-02-28. Use Get aggregated usage with filter[sys.dimensions.space.sys.id]={spaceId} instead. See the Usage migration guide for a full mapping of parameters and response shapes.

Query organization usage by space and metric for a given date range.

Authentication

AuthorizationBearer

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

Path parameters

organization_idstringRequired

Id of organization

Query parameters

metricstringOptional

Comma separated list of API types (cma,cda,cpa,gql)

startAtstringOptional

Date in yyyy-mm-dd format

endAtstringOptional

Date in yyyy-mm-dd format

orderstringOptional

Order by usage. Default value is "-usage" and describes a descending usage order.

Response headers

Content-TypestringOptional

Content-Type

Response

OK - Request successful