Get usage by organization, feature, project, app

The tutorials in this section explain how to perform various tasks within the Usage API. You can obtain your usage by filtering for your organizations, features, projects, and apps. You send a request to the Usage API to perform a task, and then receive a response containing your usage information, from the Usage API. For more details, see the Usage API reference.

Notes

The term "realm" means "organization". For more information, see Manage your organization.

The Usage API requires a realmId for each query, which is the ID for your organization.

To access the Usage API, you must create an app and credentials. See OAuth token documentation for additional details.

Usage changes can take up to two hours for Location Services and up to 48 hours for billable services usage to enact.

You cannot set usage alerts for all location services in a single rule.

Define time range

You can filter your usage using a time range, which specifies start dates, end dates, and hourly times.

    startDate (yyyy-MM-dd'T'HH:mm:ss)
    endDate (yyyy-MM-dd'T'HH:mm:ss)
    startDate (yyyy-MM-dd'T'HH:mm:ss), for example, 2021-07-01T10:39:51
    endDate (yyyy-MM-dd'T'HH:mm:ss), for example, 2021-08-30T10:39:51

Define detail level

In coordination with the time range, you can define the granularity of records from your query as summarized, hour, day, or month. By default, detailLevel is summarized, meaning granularity is at the search criteria level.