> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://contentful-staging.ferndocs.com/developers/docs/references/content-management-api/usage/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful-staging.ferndocs.com/developers/docs/_mcp/server.

Enables users to query organization API usage data.
You can further filter by Contentful API types (cma, cda, cpa, gql) through the
parameter `metric`. Results are paginated and support ordering.

### Permissions

Usage API is available to Premium/Enterprise, Basic and Free plans.
Premium/Enterprise and Basic customers can access historical usage data with API batch size of 45 days. Free plans can access the last 45 days of historical usage data.
Usage API calls can only be made by a user with the Organization Admin or Organization Owner role.

## Organization usage

Query organization usage by `metric` for a given date range.
If `startAt` and `endAt` are not passed through the query a historical data for the last 45 days will be returned by default.

[Get organization usage](/references/content-management-api/usage/get-organization-usage)

## Space usage

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

[Get space usage](/references/content-management-api/usage/get-space-usage)


## API Docs

- Usage [Get organization usage](https://contentful-staging.ferndocs.com/developers/docs/references/content-management-api/usage/get-organization-usage.md)
- Usage [Get space usage](https://contentful-staging.ferndocs.com/developers/docs/references/content-management-api/usage/get-space-usage.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://contentful-staging.ferndocs.com/developers/docs/openapi.json)
- [OpenAPI YAML](https://contentful-staging.ferndocs.com/developers/docs/openapi.yaml)