API Reference

Get host counts

get
https://api.controlup.com/historical/v1/hosts/counts

Returns usage statistics per host.

Required permission: Host Statistics

❗️

The built-in Try It! console can return incorrect values. This endpoint returns IDs that are automatically rounded and displayed incorrectly in the response body due to a Javascript limitation.

  • Use the console to build requests and test connectivity only.
  • To get accurate data, copy the request and run it in another tool.
Query Params
string
enum
required

The type of host statistics to return.

Allowed:
string

Only return statistics for the specified host name.

date-time
required

Start date and time of the search period in the format: YYYY-MM-DD'T'hh:mm:ss.sssZ

date-time
required

End date and time of the search period in the format: YYYY-MM-DD'T'hh:mm:ss.sssZ

int32
≥ 1

The page number returned. The first page is 1.

int32
1 to 100000

The number of items returned per page. Minimum is 1.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated about 2 months ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 months ago

Did this page help you?