Path parameters
-
The SID of the Sim resource to read the usage from.
Query parameters
-
Only include usage that occurred on or before this date, specified in ISO 8601. The default is the current time.
-
Only include usage that has occurred on or after this date, specified in ISO 8601. The default is one month before the
end
parameter value. -
How to summarize the usage by time. Can be:
daily
,hourly
, orall
. The default isall
. A value ofall
returns one Usage Record that describes the usage for the entire period.Values are
hourly
,daily
, orall
. -
How many resources to return in each list page. The default is 50, and the maximum is 1000.
Minimum value is
1
, maximum value is1000
. -
The page index. This value is simply for client state.
Minimum value is
0
. -
The page token. This is provided by the API.
curl \
--request GET 'https://wireless.twilio.com/v1/Sims/{SimSid}/UsageRecords' \
--user "username:password"
{
"meta": {
"key": "usage_records",
"url": "https://wireless.twilio.com/v1/Sims/DEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/UsageRecords?Start=2015-07-30T20%3A00%3A00Z&End=2015-07-30T20%3A00%3A00Z&PageSize=50&Page=0",
"page": 0,
"page_size": 50,
"next_page_url": null,
"first_page_url": "https://wireless.twilio.com/v1/Sims/DEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/UsageRecords?Start=2015-07-30T20%3A00%3A00Z&End=2015-07-30T20%3A00%3A00Z&PageSize=50&Page=0",
"previous_page_url": null
},
"usage_records": [
{
"data": {
"home": {
"total": 3494609,
"units": "bytes",
"billed": 0.35,
"upload": 731560,
"download": 2763049,
"billing_units": "USD"
},
"total": 3494609,
"units": "bytes",
"billed": 0.35,
"upload": 731560,
"download": 2763049,
"billing_units": "USD",
"national_roaming": {
"total": 0,
"units": "bytes",
"billed": 0,
"upload": 0,
"download": 0,
"billing_units": "USD"
},
"international_roaming": []
},
"period": {
"end": "2015-07-30T20:00:00Z",
"start": "2015-07-30T20:00:00Z"
},
"sim_sid": "DEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"commands": {
"home": {
"total": 3,
"billed": 0,
"to_sim": 2,
"from_sim": 1,
"billing_units": "USD"
},
"total": 3,
"billed": 0,
"to_sim": 2,
"from_sim": 1,
"billing_units": "USD",
"national_roaming": {
"total": 0,
"billed": 0,
"to_sim": 0,
"from_sim": 0,
"billing_units": "USD"
},
"international_roaming": []
},
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
},
{
"data": {},
"period": {},
"sim_sid": "DEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"commands": {},
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}
]
}