List Usage Record
GET {{v1-UsageRecords-Url}}/v1/UsageRecords?Sim=velit eiusmod exercitation&Fleet=velit eiusmod exercitation&Network=HWd82ddDFAc0B74FaC31b31395C6AA1f2e&IsoCountry=velit eiusmod exercitation&Group=sim&Granularity=day&StartTime=2006-04-04T22:55:01.091Z&EndTime=2006-04-04T22:55:01.091Z&PageSize=381
List UsageRecords
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
Sim | string | SID or unique name of a Sim resource. Only show UsageRecords representing usage incurred by this Super SIM. | |
Fleet | string | SID or unique name of a Fleet resource. Only show UsageRecords representing usage for Super SIMs belonging to this Fleet resource at the time the usage occurred. | |
Network | string | SID of a Network resource. Only show UsageRecords representing usage on this network. | |
IsoCountry | string | Alpha-2 ISO Country Code. Only show UsageRecords representing usage in this country. | |
Group | string | Dimension over which to aggregate usage records. Can be: sim , fleet , network , isoCountry . Default is to not aggregate across any of these dimensions, UsageRecords will be aggregated into the time buckets described by the Granularity parameter. | |
Granularity | string | Time-based grouping that UsageRecords should be aggregated by. Can be: hour , day , or all . Default is all . all returns one UsageRecord that describes the usage for the entire period. | |
StartTime | string | Only include usage that occurred at or after this time, specified in ISO 8601 format. Default is one month before the end_time . | |
EndTime | string | Only include usage that occurred before this time (exclusive), specified in ISO 8601 format. Default is the current time. | |
PageSize | number | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"usage_records":[{"account_sid":"AC0CCB578041E8e0Bc1aD3b47Fa8c49E6a","sim_sid":"HS9497DF52fd22e3bbef296c1C312dBe29","network_sid":"HW4Db43CeA5f6a5a09c9d0BdFF8a6f4eB8","fleet_sid":"HF2ed5E05bBfbEFc6fB55d142FFe9EfbB7","iso_country":"officia tempor in ullamco veniam","period":{},"data_upload":76725143,"data_download":7784260,"data_total":1025066,"data_total_billed":774556.875813514,"billed_unit":"quis labore irure"},{"account_sid":"ACD32F898a8CDBD5Fd69d538a343BAc6e7","sim_sid":"HSa709798DC871e48AB20DAEC1F2dFf828","network_sid":"HW63B7c41dAd99f6b1AB2bF1289e9daBa6","fleet_sid":"HFfBb4278Fb8b03B656F04dE7f08aEaFcf","iso_country":"eu incididunt id","period":{},"data_upload":79111082,"data_download":-33605812,"data_total":-56312254,"data_total_billed":-93892317.8596629,"billed_unit":"sit adipisicing in veniam"}],"meta":{"first_page_url":"https://P.orIu","next_page_url":"http://ZAVmF.kmpVBPcghUOo6zshtNXAP02.MwR","page":-63813250,"page_size":-20355636,"previous_page_url":"http://tjOUkXHVulTNjIPYnawKYQRbl.uksgZE6hG0U3eUXLQIFbDtPXB3tYBjig.y,.WAW1Pq2Zeb+w","url":"https://Edfm.kpcY.3HOM5Fl8UTT","key":"amet ea sed Excepteur"}}