# Usage Stats

```
GET 
/keys/:key/usage
```

Reports the number of lookups consumed on a key for a range of days.

A maximum interval of 90 days can be provided for analysis. If no start or end date is provided, the last 21 days will be used as the default interval.

If no `start` time is provided, the start time will be set to 21 days prior to the current time.

If no `end` time is provided, the current time will be used.

Append `tags` to scope the number of lookups to those with matching tag values. E.g. `tags=foo,bar` will only count transactions that match `foo` and `bar`.

## Request[​](#request "Direct link to request")

## Responses[​](#responses "Direct link to Responses")

* 200
* 400

Success

Bad Request