Daily SIM usage statistics

GET

https://cdn.emnify.net/api/v1/sim/:sim_id/stats/daily

GET

/api/v1/sim/:sim_id/stats/daily

1 curl https://cdn.emnify.net/api/v1/sim/sim_id/stats/daily \
2      -H "Authorization: Bearer <token>"

Try it

200Retrieved

1 [
2   {
3     "date": "2019-03-26T00:00:00.000Z",
4     "data": {
5       "volume": 0,
6       "volume_tx": 0,
7       "volume_rx": 0
8     },
9     "sms": {
10       "volume": 0,
11       "volume_tx": 0,
12       "volume_rx": 0,
13       "cost": null
14     }
15   },
16   {
17     "date": "2019-03-25T00:00:00.000Z",
18     "data": {
19       "volume": 0,
20       "volume_tx": 0,
21       "volume_rx": 0
22     },
23     "sms": {
24       "volume": 0,
25       "volume_tx": 0,
26       "volume_rx": 0,
27       "cost": null
28     }
29   },
30   {
31     "date": "2019-03-24T00:00:00.000Z",
32     "data": {
33       "volume": 0,
34       "volume_tx": 0,
35       "volume_rx": 0
36     },
37     "sms": {
38       "volume": 0,
39       "volume_tx": 0,
40       "volume_rx": 0,
41       "cost": null
42     }
43   },
44   {
45     "date": "2019-03-23T00:00:00.000Z",
46     "data": {
47       "volume": 0,
48       "volume_tx": 0,
49       "volume_rx": 0
50     },
51     "sms": {
52       "volume": 0,
53       "volume_tx": 0,
54       "volume_rx": 0,
55       "cost": null
56     }
57   },
58   {
59     "date": "2019-03-22T00:00:00.000Z",
60     "data": {
61       "volume": 0,
62       "volume_tx": 0,
63       "volume_rx": 0
64     },
65     "sms": {
66       "volume": 0,
67       "volume_tx": 0,
68       "volume_rx": 0,
69       "cost": null
70     }
71   },
72   {
73     "date": "2019-03-21T00:00:00.000Z",
74     "data": {
75       "volume": 0,
76       "volume_tx": 0,
77       "volume_rx": 0
78     },
79     "sms": {
80       "volume": 0,
81       "volume_tx": 0,
82       "volume_rx": 0,
83       "cost": null
84     }
85   },
86   {
87     "date": "2019-03-20T00:00:00.000Z",
88     "data": {
89       "volume": "0.632622",
90       "volume_tx": "0.184861",
91       "volume_rx": "0.447761",
92       "traffic_type": {
93         "description": "Data",
94         "unit": "MB",
95         "id": 5
96       },
97       "currency": null
98     },
99     "sms": {
100       "volume": 0,
101       "volume_tx": 0,
102       "volume_rx": 0,
103       "cost": null
104     }
105   },
106   {
107     "date": "2019-03-19T00:00:00.000Z",
108     "data": {
109       "volume": 0,
110       "volume_tx": 0,
111       "volume_rx": 0
112     },
113     "sms": {
114       "volume": 0,
115       "volume_tx": 0,
116       "volume_rx": 0,
117       "cost": null
118     }
119   },
120   {
121     "date": "2019-03-18T00:00:00.000Z",
122     "data": {
123       "volume": 0,
124       "volume_tx": 0,
125       "volume_rx": 0
126     },
127     "sms": {
128       "volume": 0,
129       "volume_tx": 0,
130       "volume_rx": 0,
131       "cost": null
132     }
133   },
134   {
135     "date": "2019-03-17T00:00:00.000Z",
136     "data": {
137       "volume": 0,
138       "volume_tx": 0,
139       "volume_rx": 0
140     },
141     "sms": {
142       "volume": 0,
143       "volume_tx": 0,
144       "volume_rx": 0,
145       "cost": null
146     }
147   },
148   {
149     "date": "2019-03-16T00:00:00.000Z",
150     "data": {
151       "volume": 0,
152       "volume_tx": 0,
153       "volume_rx": 0
154     },
155     "sms": {
156       "volume": 0,
157       "volume_tx": 0,
158       "volume_rx": 0,
159       "cost": null
160     }
161   },
162   {
163     "date": "2019-03-15T00:00:00.000Z",
164     "data": {
165       "volume": 0,
166       "volume_tx": 0,
167       "volume_rx": 0
168     },
169     "sms": {
170       "volume": 0,
171       "volume_tx": 0,
172       "volume_rx": 0,
173       "cost": null
174     }
175   },
176   {
177     "date": "2019-03-14T00:00:00.000Z",
178     "data": {
179       "volume": 0,
180       "volume_tx": 0,
181       "volume_rx": 0
182     },
183     "sms": {
184       "volume": 0,
185       "volume_tx": 0,
186       "volume_rx": 0,
187       "cost": null
188     }
189   },
190   {
191     "date": "2019-03-13T00:00:00.000Z",
192     "data": {
193       "volume": "0.203021",
194       "volume_tx": "0.034699",
195       "volume_rx": "0.168322",
196       "traffic_type": {
197         "description": "Data",
198         "unit": "MB",
199         "id": 5
200       },
201       "currency": null
202     },
203     "sms": {
204       "volume": 0,
205       "volume_tx": 0,
206       "volume_rx": 0,
207       "cost": null
208     }
209   },
210   {
211     "date": "2019-03-12T00:00:00.000Z",
212     "data": {
213       "volume": 0,
214       "volume_tx": 0,
215       "volume_rx": 0
216     },
217     "sms": {
218       "volume": 0,
219       "volume_tx": 0,
220       "volume_rx": 0,
221       "cost": null
222     }
223   },
224   {
225     "date": "2019-03-11T00:00:00.000Z",
226     "data": {
227       "volume": "0.970401",
228       "volume_tx": "0.268104",
229       "volume_rx": "0.702297",
230       "traffic_type": {
231         "description": "Data",
232         "unit": "MB",
233         "id": 5
234       },
235       "currency": null
236     },
237     "sms": {
238       "volume": 0,
239       "volume_tx": 0,
240       "volume_rx": 0,
241       "cost": null
242     }
243   },
244   {
245     "date": "2019-03-10T00:00:00.000Z",
246     "data": {
247       "volume": 0,
248       "volume_tx": 0,
249       "volume_rx": 0
250     },
251     "sms": {
252       "volume": 0,
253       "volume_tx": 0,
254       "volume_rx": 0,
255       "cost": null
256     }
257   },
258   {
259     "date": "2019-03-09T00:00:00.000Z",
260     "data": {
261       "volume": 0,
262       "volume_tx": 0,
263       "volume_rx": 0
264     },
265     "sms": {
266       "volume": 0,
267       "volume_tx": 0,
268       "volume_rx": 0,
269       "cost": null
270     }
271   },
272   {
273     "date": "2019-03-08T00:00:00.000Z",
274     "data": {
275       "volume": 0,
276       "volume_tx": 0,
277       "volume_rx": 0
278     },
279     "sms": {
280       "volume": 0,
281       "volume_tx": 0,
282       "volume_rx": 0
283     }
284   },
285   {
286     "date": "2019-03-07T00:00:00.000Z",
287     "data": {
288       "volume": "0.447510",
289       "volume_tx": "0.152494",
290       "volume_rx": "0.295016",
291       "traffic_type": {
292         "description": "Data",
293         "unit": "MB",
294         "id": 5
295       },
296       "currency": null
297     },
298     "sms": {
299       "volume": 0,
300       "volume_tx": 0,
301       "volume_rx": 0,
302       "cost": null
303     }
304   },
305   {
306     "date": "2019-03-06T00:00:00.000Z",
307     "data": {
308       "volume": "1.803505",
309       "volume_tx": "0.469397",
310       "volume_rx": "1.334108",
311       "traffic_type": {
312         "description": "Data",
313         "unit": "MB",
314         "id": 5
315       },
316       "currency": null
317     },
318     "sms": {
319       "volume": 0,
320       "volume_tx": 0,
321       "volume_rx": 0,
322       "cost": null
323     }
324   },
325   {
326     "date": "2019-03-05T00:00:00.000Z",
327     "data": {
328       "volume": "9.871023",
329       "volume_tx": "1.647476",
330       "volume_rx": "8.223547",
331       "traffic_type": {
332         "description": "Data",
333         "unit": "MB",
334         "id": 5
335       },
336       "currency": null
337     },
338     "sms": {
339       "volume": 0,
340       "volume_tx": 0,
341       "volume_rx": 0,
342       "cost": null
343     }
344   },
345   {
346     "date": "2019-03-04T00:00:00.000Z",
347     "data": {
348       "volume": 0,
349       "volume_tx": 0,
350       "volume_rx": 0
351     },
352     "sms": {
353       "volume": 0,
354       "volume_tx": 0,
355       "volume_rx": 0,
356       "cost": null
357     }
358   },
359   {
360     "date": "2019-03-03T00:00:00.000Z",
361     "data": {
362       "volume": 0,
363       "volume_tx": 0,
364       "volume_rx": 0
365     },
366     "sms": {
367       "volume": 0,
368       "volume_tx": 0,
369       "volume_rx": 0,
370       "cost": null
371     }
372   },
373   {
374     "date": "2019-03-02T00:00:00.000Z",
375     "data": {
376       "volume": 0,
377       "volume_tx": 0,
378       "volume_rx": 0
379     },
380     "sms": {
381       "volume": 0,
382       "volume_tx": 0,
383       "volume_rx": 0,
384       "cost": null
385     }
386   },
387   {
388     "date": "2019-03-01T00:00:00.000Z",
389     "data": {
390       "volume": 0,
391       "volume_tx": 0,
392       "volume_rx": 0
393     },
394     "sms": {
395       "volume": 0,
396       "volume_tx": 0,
397       "volume_rx": 0,
398       "cost": null
399     }
400   },
401   {
402     "date": "TOTAL",
403     "data": {
404       "volume": "13.928082",
405       "volume_tx": "2.757031",
406       "volume_rx": "11.171051",
407       "traffic_type": {
408         "description": "Data",
409         "unit": "MB",
410         "id": 5
411       },
412       "currency": null
413     },
414     "sms": {
415       "volume": 0,
416       "volume_tx": 0,
417       "volume_rx": 0,
418       "cost": 0,
419       "traffic_type": "",
420       "currency": ""
421     }
422   }
423 ]

Data traffic cost statistics (cost field in the data object) have been deprecated.

Retrieves SIM usage statistics accumulated per day. By default, the response includes statistics for the current month.

start_date and an end_date can be provided as query parameters to retrieve statistics for a specific time frame.

Example request: /api/v1/sim/123/stats/daily?end_date=2019-03-21&start_date=2019-03-01

<Warning> Data traffic cost statistics (`cost` field in the `data` object) have been deprecated. </Warning> Retrieves SIM usage statistics accumulated per day. By default, the response includes statistics for the current month. `start_date` and an `end_date` can be provided as query parameters to retrieve statistics for a specific time frame. Example request: `/api/v1/sim/123/stats/daily?end_date=2019-03-21&start_date=2019-03-01`

Authentication

AuthorizationBearer

An auth_token should be provided to authenticate a session.

To obtain an auth_token, see the /api/v1/authenticate POST request.

Path parameters

sim_idstringRequired

Response

Successfully returned the daily SIM statistics for the provided dates and ID.