Skip to content

Usage Summary.

GET
/api/shape/bot/namespaces/{namespace}/reporting/usage/summary
curl --request GET \
--url https://example-corp.console.ves.volterra.io/api/v1/api/production/us-east-1/namespaces/default/api/shape/bot/namespaces/example/reporting/usage/summary \
--header 'Authorization: <Authorization>'

GET transactions usage summary.

Examples of this operation.

namespace
required
string

Namespace

x-required namespace is used to scope traffic usage query. Only virtual_host in given namespace will be considered.

start
string

Or “2022-08-01” The start date of the query period. Format: YYYY-MM or YYYY-MM-DD.

end
string

Or “2022-09-30” The end date of the query period. Format: YYYY-MM or YYYY-MM-DD.

A successful response.

Media typeapplication/json
TransactionUsageSummaryResponse

Response for Transaction Usage Summary.

object
records
Monthly Usage Summary Records

Per month usage summary data.

Array<object>
object
all
All Traffic

All traffic counter.

string format: uint64
<= 1024 characters
js
JS Traffic

Counts the number of Bot JS requests.

string format: uint64
<= 1024 characters
mobile_config
Mobile SDK Config Traffic

Counts the number of Bot Mobile SDK Config requests.

string format: uint64
<= 1024 characters
month
Month

Month Identifier, format: YYYYMM.

string
<= 1024 characters
Examplegenerated
{
"records": [
{
"all": "example",
"js": "example",
"mobile_config": "example",
"month": "example"
}
]
}

Returned when operation is not authorized.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when there is no permission to access resource.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when resource is not found.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when operation on resource is conflicting with current value.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when operation has been rejected as it is happening too frequently.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when server encountered an error in processing API.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when service is unavailable temporarily.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when server timed out processing request.

Media typeapplication/json
string format: string
Examplegenerated
example