# API Daily History

**POST /Api/Read/History**

This process returns the daily history details of successful API calls for the past 7 days grouped by remote ip address and endpoint for your API Key.  After a week, the history records get merged together by ACL id with no remote IP addres.
*Secret Hmac Required. Cache Time 30 minutes. [Multiple pages possible](#topic-multiple-pages).*



## Servers
- https://Api.StrandVision.com/v1.0: https://Api.StrandVision.com/v1.0 ()


## Authentication methods
- Authorization key & Authorization date & Authorization hmac


## Parameters



### Body:  (object)

- **HistoryDays** (number)
  If not passed, this defaults to 7 days of history.
- **HistoryGroup** (string)
  If passed, the query will group the database query.
- **HistoryFields** (string)
  If passed, these fields will be gathered (important for accumulating counts for grouping).


## Responses
### 200
API History successfully returned

#### Body:  (array[object])
- **Date** (string)
  YYYY-MM-DD date that the API call was requested
- **Server_Addr** (string)
  The ipv4 server address.
- **Remote_Addr** (string)
  The ipv4 remote address.
- **Count** (number)
  The number of successful requests for this date
- **CpuTime** (string)
  The total CPU time as text.
- **CpuSeconds** (number)
  The total CPU time in seconds
- **FailCount** (number)
  The number of successful requests for this date
- **LimitTime** (string)
  The total time paused due to limits reached as text.
- **LimitSeconds** (number)
  The total time paused due to limits reached in seconds
- **BandWidth** (string)
  The total bandwidth used by these API calls as text.
- **Bytes** (number)
  The total bandwidth used by these API calls in bytes.
- **Api_Acl** (number)
  The acl id for the call
- **Api_Function** (string)
  the endpoint that was called.


[Powered by Bump.sh](https://bump.sh)