# Viewer Records

```
POST 
/api/records/viewers
```

Returns a range of viewer connection records, with optional start-time and completion-time filters. Includes ongoing (not yet completed) connections by default. Each ClientId appears as a single record. If a session reconnects after being marked complete, it is returned as one record with duration and bytes accumulated from the original session start.

To poll for new or updated records, set StartTime to your last checkpoint and advance it on each call. Dedupe results by ClientId.

To fetch completed records up to a point in time, set Search=Completed with EndTime as the upper bound on completion time. EndTime is one-sided: repeated calls with the same EndTime return every record completed before that time each time, not only the ones newly completed since your last call. Do not use this for non-overlapping usage or billing tallies - use v2's CompletedAfter/CompletedBefore for that.

## Request

## Responses

**200**

Success