# Usage

**id** string required

Unique identifier for the usage metric

**name** string required

Display name for customer invoice

**description** string required

Human readable description of the usage metric

**unit** string required

Unit of measurement

**values** object[] required

Array [
    
    **starting_on** date-time required
    
    RFC3339 formatted UTC timestamp for starting period
    
    **Example:** `2021-09-01T01:00:00Z`
    
    **ending_before** date-time required
    
    RFC3339 formatted UTC timestamp for ending period
    
    **Example:** `2021-09-01T02:00:00Z`
    
    **value** double required
    
    Usage value for the period
    
]

Usage

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "unit": "string",
  "values": [
    {
      "starting_on": "2021-09-01T01:00:00Z",
      "ending_before": "2021-09-01T02:00:00Z",
      "value": 0
    }
  ]
}
```