Sign in

v10

latestOpenAPI 3.0.1raw.githubusercontent.com2025-12-033223581.2 MB
DataExplorerV2

Query and filter usage data

Query and filter usage data collected for your Organization.

You can use several parameters to filter the range of usage data returned:

  • Time period. Use startDate and endDate to define a period. The query references the timestamp values of usage data submissions for applying the defined time period, and not the time submissions were receivedAt by the platform. Only usage data with a timestamp that falls in the defined time period are returned.(Required)
  • Meters. Specify the Meters you want the query to return data for.
  • Accounts. Specify the Accounts you want the query to return data for.
  • Dimension Filters. Specify values for Dimension data fields on included Meters. Only data that match the specified Dimension field values will be returned for the query.

You can apply Aggregations functions to the usage data returned for the query. If you apply Aggregations, you can select to group the data by:

  • Account
  • Time
  • Dimension
post/organizations/{orgId}/usage/query

Path parameters

orgIdstring required

UUID of the Organization. The Organization represents your company as a direct customer of the m3ter service.

Request body

startDatestring date-time

The inclusive start date to define a time period to filter by. (ISO 8601 formatted)

endDatestring date-time

The exclusive end date to define a time period to filter by. (ISO 8601 formatted)

Response

Returns a list of usage data

dataobject[]
hasMoreDataboolean

Boolean flag to indicate whether or not there are more data available for the query than are returned:

  • If there are more data, then TRUE.
  • If there are no more data, then FALSE.

NOTES:

  • The limit on the size of the return is 20000 data items. If the query returns more than this limit, only 20000 items are returned with most recent first and hasMoreData will be TRUE.
  • If you have set limit in your query request at fewer than the number returned by the query, then hasMoreData will be TRUE in the response.