## List

**post** `/v1/usage`

Fetch aggregated usage data for multiple customers and billable-metrics, broken into intervals of the specified length.

### Returns

- **data:** `array of object`

  - **billable\_metric\_id:** `string`

  - **billable\_metric\_name:** `string`

  - **customer\_id:** `string`

  - **end\_timestamp:** `string`

  - **start\_timestamp:** `string`

  - **value:** `number`

  - **groups:** `map[number]`

    Values will be either a number or null. Null indicates that there were no matches for the group_by value.

- **next\_page:** `string`