Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Description

Returns current system usage statistics for given time period.
With Usage Statistics, it is possible to track how client usage of the system is growing over time in order to have a transparent view of client billing which is correlated.

Request path

POST GET [REST URL]/usagestatistics/get

Query Parameters

Parameter

Type

Description

fromDate

Datetime typeDatetime 

/

toDate

Datetime type

/
aggregationPeriodStringauto, daily, monthly

Response Parameters

Parameter

Type

Description

fromDate

Datetime

type

from the request

toDate

Datetime

type

from the request

KPI object

/

name, description, unit, value

Notes:

  1.  fromDate and toDate can have a range of 3 years maximum, with a minimum interval of "month". "
day
  1. Day" interval
work
  1. works for a range (toDate-fromDate) within 1 month
from
  1. of the current date. "
month
  1. Month" interval works for a range (toDate-fromDate) outside of the last month from the current date.
  2. Optional parameter aggregationPeriod with 3 options:
  • auto - default if not specified, behave as previously
  • daily - force daily aggregation
  • monthly - force monthly aggregation

Request Body Type

list of Attribute arguments


Example

bodies

response body:

Code Block
{
    "fromDate": "2022-07-01",
    "toDate": "2022-09-27",
    "kpis": [
        {
            "name": "
totalnoofapi2.0callsresponsesize_/usagestatistics/get",
totalnoofmessagesbounced",
            "description": "Total no. of 
API
messages 
2.0
bounced 
response
across 
sizes
all 
sent
domains 
per
in 
method
system",
            "unit": "
MB
UNIT",
            "counters": [
                {
                    "timestamp": "2022-07-01",
                    "value": 
"2020
"8"
                },
                {
                    "timestamp": "2022-08-01",
                    "value": "
0,11
2"
                },
                {
                    "timestamp": "
2020
2022-
08
09-
02
01",
                    "value": "0
,11"
"
                }
            ]
        }