For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Request featuresContact support
DocsAPI ReferenceGraphQLIntegrationsDeveloper Tools
DocsAPI ReferenceGraphQLIntegrationsDeveloper Tools
  • Authentication
    • POSTRetrieve authentication token
    • POSTCreate an MFA key
    • PATCHActivate MFA key
    • DELDelete an MFA key
    • GETList MFA key statuses
    • GETList MFA key types
    • GETList trusted devices
    • DELDelete a trusted device
  • Password Management and Activation
    • POSTInvite a user
    • POSTActivate user
    • POSTResend user activation email
    • PATCHChange password
  • Endpoint
    • GETList endpoints
    • POSTCreate an endpoint
    • POSTBulk create endpoints
    • DELBulk delete endpoints
    • PATCHBulk update endpoints
    • GETList endpoint statuses
    • GETEndpoint details
    • DELDelete an endpoint
    • PATCHUpdate an endpoint
    • GETEndpoint connectivity status
    • PATCHReset endpoint connectivity
    • GETList endpoint events
    • GETEndpoint usage and cost statistics
    • GETRetrieve daily usage statistics for an endpoint
    • GETList sent and received SMS
    • POSTSend SMS to an endpoint
    • GETSMS details
    • DELCancel SMS
    • GETRetrieve connectivity information for an endpoint
    • GETList active traffic limit extensions
    • POSTCreate traffic limit extension
    • DELDelete all traffic limit extensions for an endpoint
    • GETList operator blacklist for endpoint
    • PUTAdd an operator to the blacklist
    • DELRemove an operator from the blacklist
    • GETRetrieve data quota details
    • POSTSet data quota
    • DELRemove data quota
    • GETShow SMS quota details
    • POSTSet SMS quota
    • DELRemove SMS quota
  • Organization
    • GETOrganization usage and costs statistics per day for the current month
    • GETMy organization details
    • GETList organization statuses
    • GETMonthly organization traffic and cost statistics
    • GETDaily organization traffic and cost statistics
    • GETHourly organization traffic statistics
    • PATCHUpdate assigned tariff
    • PUTAssign a ratezone inclusive volume to an organization
    • GETGet list of active organization inclusive volumes
  • Sim
    • GETList SIMs
    • GETList SIM statuses
    • GETSIM details
    • DELDelete a SIM
    • PATCHUpdate a SIM
    • GETSIM usage and cost statistics
    • GETDaily SIM usage statistics
    • GETList SIM events
    • GETValidate SIM batch by BIC
    • PATCHRegister a given batch by BIC
    • DELBulk delete SIMs
    • POSTMigrate SIMs between Workspaces
  • Events
    • GETList events
    • GETList event types
  • Lookups
    • GETList country codes
    • GETList currencies
    • GETList data blocksizes
    • GETList data throttles
    • GETList breakout regions
    • GETList ESME interface types
    • GETList RAT types
    • GETGet list of service levels
  • Operator
    • GETList operators
  • Application Tokens
    • GETList application tokens
    • POSTCreate application token
    • PATCHUpdate application token
  • Tariff Profiles
    • GETList tariff profiles
    • POSTCreate tariff profile
    • GETTariff profile details
    • DELDelete tariff profile
    • PATCHUpdate tariff profile
    • PUTAssign ratezone to tarriff profile
    • DELDelete ratezone from tariff profile
    • GETGet the operator blocklist for a specific tariff profile
    • GETGet operator blocklist for a specific tariff profile
    • PUTBlock the operator completely for a given tariff profile
    • DELRemove an operator from the blocklist
    • POSTBlock specific RAT types
    • DELUnblock a specific RAT type
    • GETList tariff profile coverage
    • PUTAssign inclusive volume to tarriff profile
    • DELUnassign inclusive volume from tariff profile
  • Service Profiles
    • GETList service profiles
    • POSTCreate service profile
    • GETRetrieve a service profile
    • DELDelete a service profile
    • PATCHUpdate service profile
    • DELRemove all quotas of assigned endpoints
    • PUTAdd a service to a service profile
    • DELRemove a service from a service profile
    • PUTAdd SMS limit to service profile
    • DELRemove SMS limit from a service profile
    • GETList data limits of service profile
    • POSTAdd data limit to service profile
    • DELDelete all data limits of a service profile
    • DELRemove data limit from a service profile
  • Service Lookups and Configuration
    • GETList services
    • GETGet service SMS limit
    • GETList traffic limits
    • GETList DNS configs
    • POSTCreate DNS config
    • DELDelete DNS config
  • User Management
    • GETList user accounts
    • POSTCreate user
    • GETList user statuses
    • GETList user roles
    • GETGet user by ID or username
    • DELDelete user by ID
    • PATCHUpdate user by ID
    • GETList user events
    • GETList user role permissions
    • PUTAssign role to user
    • DELDelete user role
    • DELDelete user by ID
    • POSTCreate support access token for given user
  • IP Address Spaces
    • GETList IP address spaces
    • POSTCreate an IP address space
    • GETGet random address spaces
    • PUTAssign an IP address space to an organization
    • DELRelease an IP address space from an organization
  • Integrations
    • GETList data stream configurations of your organization
    • POSTCreate data stream
    • GETGet data stream statuses
    • GETGet data stream types
    • GETGet data stream filter fields
    • GETGet details on existing data stream
    • DELDelete existing data stream
    • PATCHModify existing data stream
    • POSTRestart existing data stream
    • GETRetrieve list of API callback URLs
    • POSTCreate a callback URL
    • GETGet a callback URL by ID
    • DELDelete a callback URL
    • GETList API callback secrets
    • POSTCreate a callback secret
    • GETGet a callback secret by ID
    • DELDelete a callback secret
  • Cloud Connect
    • GETList all Cloud Connect attachments of an organization
    • GETList Cloud Connect breakout types
    • GETView details of a Cloud Connect attachment
    • DELDelete a specific Cloud Connect attachment
    • PATCHRetry creation of an expired TGW breakout
    • POSTCreate a Cloud Connect attachment via Transit Gateway
    • POSTCreate a Cloud Connect attachment via IPSec VPN
    • GETList Cloud Connect prices
    • GETGet list of available Cloud Connect regions by breakout type
  • Tariff Plans
    • GETList organization tariff plans
    • GETRetrieve your organization's active tariff plan
    • GETGet the active tariff plan for the given organization
  • Workspaces
    • POSTSwitch to an assigned Workspace
    • POSTAccept user invitation
    • PUTAssign a role to a Workspace user
    • DELRemove a role from a Workspace user
    • PUTUpdate a user's default Workspace
    • GETList assigned Workspaces
    • DELUnassign a Workspace
    • PATCHUpdate user status in a Workspace
    • GETRetrieve Workspace daily stats
  • Tag Management
    • GETReturns the list of available tag colors
    • GETList tags
    • POSTCreate a tag
    • DELDelete a tag
    • PATCHUpdate a tag
    • GETList endpoint tags
    • POSTAssign a tag to an endpoint
    • DELUnassign a tag from an endpoint
    • POSTBulk assign tags
    • POSTBulk unassign tags
    • POSTBulk delete tags
  • Automations
    • GETList action logs
    • GETList available actions
    • GETGet an action by ID
    • GETList configured automations
    • POSTCreate an automation
    • GETGet configured automation by ID
    • DELDelete a configured automation
    • PATCHUpdate an automation
    • POSTVerify an automation recipient's email address
  • System Events
    • GETList system events
    • GETGet a system event by ID
  • Custom Events
    • GETList custom event templates
    • GETGet a custom event template by ID
    • GETList custom events
    • POSTDeploy custom event
    • GETGet a custom event by ID
    • DELDelete custom event
  • euicc
    • GETList eUICCs
    • GETList eUICC status
    • GETList eUICC Profile status
    • GETGet eUICC
    • POSTUnlinked eUICC validation
  • Euicc Operation
    • GETList operation action for eUICC
    • GETList operation status for eUICC
    • GETList operation for eUICC
    • POSTSchedule eUICC operations
    • GETGet operation details
    • DELCancel operation
  • Sim Unlinked Product Statistics
    • GETGet product statistics on unlinked eSIMs
  • Sim Operation
    • GETList SIM operation actions
    • GETList SIM operation status
    • GETList SIM operations for organization
    • POSTTrigger SIM operation
    • GETGet SIM operation details
LogoLogo
Request featuresContact support
Sim

SIM usage and cost statistics

GET
https://cdn.emnify.net/api/v1/sim/:sim_id/stats
GET
/api/v1/sim/:sim_id/stats
$curl https://cdn.emnify.net/api/v1/sim/sim_id/stats \
> -H "Authorization: Bearer <token>"
200Retrieved
1[
2 {
3 "last_month": {
4 "data": {
5 "sim_id": 123456,
6 "month": "2024-02-01T00:00:00.000Z",
7 "volume": 29.166235,
8 "volume_tx": 5.577229,
9 "volume_rx": 23.589006,
10 "traffic_type_id": 5,
11 "last_updated": "2024-02-20T14:56:25.000Z",
12 "cost": 6.10483935,
13 "currency_id": 1,
14 "id": 1234562024025,
15 "traffic_type": {
16 "description": "Data",
17 "unit": "MB",
18 "id": 5
19 },
20 "currency": {
21 "code": "EUR",
22 "symbol": "€",
23 "id": 1
24 }
25 },
26 "sms": {
27 "sim_id": 123456,
28 "month": "2024-02-01T00:00:00.000Z",
29 "volume": 51,
30 "volume_tx": 36,
31 "volume_rx": 15,
32 "traffic_type_id": 6,
33 "last_updated": "2024-02-26T10:52:42.000Z",
34 "cost": 3.32,
35 "currency_id": 1,
36 "id": 1234562024026,
37 "traffic_type": {
38 "description": "SMS",
39 "unit": "SMS",
40 "id": 6
41 },
42 "currency": {
43 "code": "EUR",
44 "symbol": "€",
45 "id": 1
46 }
47 }
48 },
49 "current_month": {
50 "data": {
51 "sim_id": 123456,
52 "month": "2024-03-01T00:00:00.000Z",
53 "volume": 0.848157,
54 "volume_tx": 0.172846,
55 "volume_rx": 0.675311,
56 "traffic_type_id": 5,
57 "last_updated": "2024-03-01T15:12:53.000Z",
58 "cost": 0.21203925,
59 "currency_id": 1,
60 "id": 1234562024035,
61 "traffic_type": {
62 "description": "Data",
63 "unit": "MB",
64 "id": 5
65 },
66 "currency": {
67 "code": "EUR",
68 "symbol": "€",
69 "id": 1
70 }
71 },
72 "sms": {
73 "sim_id": 123456,
74 "month": "2024-03-01T00:00:00.000Z",
75 "volume": 3,
76 "volume_tx": 2,
77 "volume_rx": 1,
78 "traffic_type_id": 6,
79 "last_updated": "2024-03-01T14:20:42.000Z",
80 "cost": 0.17,
81 "currency_id": 1,
82 "id": 1234562024036,
83 "traffic_type": {
84 "description": "SMS",
85 "unit": "SMS",
86 "id": 6
87 },
88 "currency": {
89 "code": "EUR",
90 "symbol": "€",
91 "id": 1
92 }
93 }
94 },
95 "last_hour": {
96 "data": {
97 "rx": [
98 [
99 "06:38",
100 0
101 ],
102 [
103 "06:39",
104 0
105 ],
106 [
107 "06:40",
108 0
109 ],
110 [
111 "06:41",
112 0
113 ],
114 [
115 "06:42",
116 0
117 ],
118 [
119 "06:43",
120 0
121 ],
122 [
123 "06:44",
124 0
125 ],
126 [
127 "06:45",
128 0
129 ],
130 [
131 "06:46",
132 0
133 ],
134 [
135 "06:47",
136 0
137 ],
138 [
139 "06:48",
140 0
141 ],
142 [
143 "06:49",
144 0
145 ],
146 [
147 "06:50",
148 0
149 ],
150 [
151 "06:51",
152 0
153 ],
154 [
155 "06:52",
156 0
157 ],
158 [
159 "06:53",
160 0
161 ],
162 [
163 "06:54",
164 0
165 ],
166 [
167 "06:55",
168 0
169 ],
170 [
171 "06:56",
172 0
173 ],
174 [
175 "06:57",
176 0
177 ],
178 [
179 "06:58",
180 0
181 ],
182 [
183 "06:59",
184 0
185 ],
186 [
187 "07:00",
188 0
189 ],
190 [
191 "07:01",
192 0
193 ],
194 [
195 "07:02",
196 0
197 ],
198 [
199 "07:03",
200 0
201 ],
202 [
203 "07:04",
204 0
205 ],
206 [
207 "07:05",
208 0
209 ],
210 [
211 "07:06",
212 0
213 ],
214 [
215 "07:07",
216 0
217 ],
218 [
219 "07:08",
220 0
221 ],
222 [
223 "07:09",
224 0
225 ],
226 [
227 "07:10",
228 0
229 ],
230 [
231 "07:11",
232 0
233 ],
234 [
235 "07:12",
236 0
237 ],
238 [
239 "07:13",
240 0
241 ],
242 [
243 "07:14",
244 0
245 ],
246 [
247 "07:15",
248 0
249 ],
250 [
251 "07:16",
252 0
253 ],
254 [
255 "07:17",
256 0
257 ],
258 [
259 "07:18",
260 0
261 ],
262 [
263 "07:19",
264 0
265 ],
266 [
267 "07:20",
268 0
269 ],
270 [
271 "07:21",
272 0
273 ],
274 [
275 "07:22",
276 0
277 ],
278 [
279 "07:23",
280 0
281 ],
282 [
283 "07:24",
284 0
285 ],
286 [
287 "07:25",
288 0
289 ],
290 [
291 "07:26",
292 0
293 ],
294 [
295 "07:27",
296 0
297 ],
298 [
299 "07:28",
300 0
301 ],
302 [
303 "07:29",
304 0
305 ],
306 [
307 "07:30",
308 0
309 ],
310 [
311 "07:31",
312 0
313 ],
314 [
315 "07:32",
316 0
317 ],
318 [
319 "07:33",
320 0
321 ],
322 [
323 "07:34",
324 0
325 ],
326 [
327 "07:35",
328 0
329 ],
330 [
331 "07:36",
332 0
333 ]
334 ],
335 "tx": [
336 [
337 "06:38",
338 0
339 ],
340 [
341 "06:39",
342 0
343 ],
344 [
345 "06:40",
346 0
347 ],
348 [
349 "06:41",
350 0
351 ],
352 [
353 "06:42",
354 0
355 ],
356 [
357 "06:43",
358 0
359 ],
360 [
361 "06:44",
362 0
363 ],
364 [
365 "06:45",
366 0
367 ],
368 [
369 "06:46",
370 0
371 ],
372 [
373 "06:47",
374 0
375 ],
376 [
377 "06:48",
378 0
379 ],
380 [
381 "06:49",
382 0
383 ],
384 [
385 "06:50",
386 0
387 ],
388 [
389 "06:51",
390 0
391 ],
392 [
393 "06:52",
394 0
395 ],
396 [
397 "06:53",
398 0
399 ],
400 [
401 "06:54",
402 0
403 ],
404 [
405 "06:55",
406 0
407 ],
408 [
409 "06:56",
410 0
411 ],
412 [
413 "06:57",
414 0
415 ],
416 [
417 "06:58",
418 0
419 ],
420 [
421 "06:59",
422 0
423 ],
424 [
425 "07:00",
426 0
427 ],
428 [
429 "07:01",
430 0
431 ],
432 [
433 "07:02",
434 0
435 ],
436 [
437 "07:03",
438 0
439 ],
440 [
441 "07:04",
442 0
443 ],
444 [
445 "07:05",
446 0
447 ],
448 [
449 "07:06",
450 0
451 ],
452 [
453 "07:07",
454 0
455 ],
456 [
457 "07:08",
458 0
459 ],
460 [
461 "07:09",
462 0
463 ],
464 [
465 "07:10",
466 0
467 ],
468 [
469 "07:11",
470 0
471 ],
472 [
473 "07:12",
474 0
475 ],
476 [
477 "07:13",
478 0
479 ],
480 [
481 "07:14",
482 0
483 ],
484 [
485 "07:15",
486 0
487 ],
488 [
489 "07:16",
490 0
491 ],
492 [
493 "07:17",
494 0
495 ],
496 [
497 "07:18",
498 0
499 ],
500 [
501 "07:19",
502 0
503 ],
504 [
505 "07:20",
506 0
507 ],
508 [
509 "07:21",
510 0
511 ],
512 [
513 "07:22",
514 0
515 ],
516 [
517 "07:23",
518 0
519 ],
520 [
521 "07:24",
522 0
523 ],
524 [
525 "07:25",
526 0
527 ],
528 [
529 "07:26",
530 0
531 ],
532 [
533 "07:27",
534 0
535 ],
536 [
537 "07:28",
538 0
539 ],
540 [
541 "07:29",
542 0
543 ],
544 [
545 "07:30",
546 0
547 ],
548 [
549 "07:31",
550 0
551 ],
552 [
553 "07:32",
554 0
555 ],
556 [
557 "07:33",
558 0
559 ],
560 [
561 "07:34",
562 0
563 ],
564 [
565 "07:35",
566 0
567 ],
568 [
569 "07:36",
570 0
571 ]
572 ]
573 },
574 "sms": {
575 "rx": [
576 [
577 "06:38",
578 0
579 ],
580 [
581 "06:39",
582 0
583 ],
584 [
585 "06:40",
586 0
587 ],
588 [
589 "06:41",
590 0
591 ],
592 [
593 "06:42",
594 0
595 ],
596 [
597 "06:43",
598 0
599 ],
600 [
601 "06:44",
602 0
603 ],
604 [
605 "06:45",
606 0
607 ],
608 [
609 "06:46",
610 0
611 ],
612 [
613 "06:47",
614 0
615 ],
616 [
617 "06:48",
618 0
619 ],
620 [
621 "06:49",
622 0
623 ],
624 [
625 "06:50",
626 0
627 ],
628 [
629 "06:51",
630 0
631 ],
632 [
633 "06:52",
634 0
635 ],
636 [
637 "06:53",
638 0
639 ],
640 [
641 "06:54",
642 0
643 ],
644 [
645 "06:55",
646 0
647 ],
648 [
649 "06:56",
650 0
651 ],
652 [
653 "06:57",
654 0
655 ],
656 [
657 "06:58",
658 0
659 ],
660 [
661 "06:59",
662 0
663 ],
664 [
665 "07:00",
666 0
667 ],
668 [
669 "07:01",
670 0
671 ],
672 [
673 "07:02",
674 0
675 ],
676 [
677 "07:03",
678 0
679 ],
680 [
681 "07:04",
682 0
683 ],
684 [
685 "07:05",
686 0
687 ],
688 [
689 "07:06",
690 0
691 ],
692 [
693 "07:07",
694 0
695 ],
696 [
697 "07:08",
698 0
699 ],
700 [
701 "07:09",
702 0
703 ],
704 [
705 "07:10",
706 0
707 ],
708 [
709 "07:11",
710 0
711 ],
712 [
713 "07:12",
714 0
715 ],
716 [
717 "07:13",
718 0
719 ],
720 [
721 "07:14",
722 0
723 ],
724 [
725 "07:15",
726 0
727 ],
728 [
729 "07:16",
730 0
731 ],
732 [
733 "07:17",
734 0
735 ],
736 [
737 "07:18",
738 0
739 ],
740 [
741 "07:19",
742 0
743 ],
744 [
745 "07:20",
746 0
747 ],
748 [
749 "07:21",
750 0
751 ],
752 [
753 "07:22",
754 0
755 ],
756 [
757 "07:23",
758 0
759 ],
760 [
761 "07:24",
762 0
763 ],
764 [
765 "07:25",
766 0
767 ],
768 [
769 "07:26",
770 0
771 ],
772 [
773 "07:27",
774 0
775 ],
776 [
777 "07:28",
778 0
779 ],
780 [
781 "07:29",
782 0
783 ],
784 [
785 "07:30",
786 0
787 ],
788 [
789 "07:31",
790 0
791 ],
792 [
793 "07:32",
794 0
795 ],
796 [
797 "07:33",
798 0
799 ],
800 [
801 "07:34",
802 0
803 ],
804 [
805 "07:35",
806 0
807 ],
808 [
809 "07:36",
810 0
811 ]
812 ],
813 "tx": [
814 [
815 "06:38",
816 0
817 ],
818 [
819 "06:39",
820 0
821 ],
822 [
823 "06:40",
824 0
825 ],
826 [
827 "06:41",
828 0
829 ],
830 [
831 "06:42",
832 0
833 ],
834 [
835 "06:43",
836 0
837 ],
838 [
839 "06:44",
840 0
841 ],
842 [
843 "06:45",
844 0
845 ],
846 [
847 "06:46",
848 0
849 ],
850 [
851 "06:47",
852 0
853 ],
854 [
855 "06:48",
856 0
857 ],
858 [
859 "06:49",
860 0
861 ],
862 [
863 "06:50",
864 0
865 ],
866 [
867 "06:51",
868 0
869 ],
870 [
871 "06:52",
872 0
873 ],
874 [
875 "06:53",
876 0
877 ],
878 [
879 "06:54",
880 0
881 ],
882 [
883 "06:55",
884 0
885 ],
886 [
887 "06:56",
888 0
889 ],
890 [
891 "06:57",
892 0
893 ],
894 [
895 "06:58",
896 0
897 ],
898 [
899 "06:59",
900 0
901 ],
902 [
903 "07:00",
904 0
905 ],
906 [
907 "07:01",
908 0
909 ],
910 [
911 "07:02",
912 0
913 ],
914 [
915 "07:03",
916 0
917 ],
918 [
919 "07:04",
920 0
921 ],
922 [
923 "07:05",
924 0
925 ],
926 [
927 "07:06",
928 0
929 ],
930 [
931 "07:07",
932 0
933 ],
934 [
935 "07:08",
936 0
937 ],
938 [
939 "07:09",
940 0
941 ],
942 [
943 "07:10",
944 0
945 ],
946 [
947 "07:11",
948 0
949 ],
950 [
951 "07:12",
952 0
953 ],
954 [
955 "07:13",
956 0
957 ],
958 [
959 "07:14",
960 0
961 ],
962 [
963 "07:15",
964 0
965 ],
966 [
967 "07:16",
968 0
969 ],
970 [
971 "07:17",
972 0
973 ],
974 [
975 "07:18",
976 0
977 ],
978 [
979 "07:19",
980 0
981 ],
982 [
983 "07:20",
984 0
985 ],
986 [
987 "07:21",
988 0
989 ],
990 [
991 "07:22",
992 0
993 ],
994 [
995 "07:23",
996 0
997 ],
998 [
999 "07:24",
1000 0
1001 ],
1002 [
1003 "07:25",
1004 0
1005 ],
1006 [
1007 "07:26",
1008 0
1009 ],
1010 [
1011 "07:27",
1012 0
1013 ],
1014 [
1015 "07:28",
1016 0
1017 ],
1018 [
1019 "07:29",
1020 0
1021 ],
1022 [
1023 "07:30",
1024 0
1025 ],
1026 [
1027 "07:31",
1028 0
1029 ],
1030 [
1031 "07:32",
1032 0
1033 ],
1034 [
1035 "07:33",
1036 0
1037 ],
1038 [
1039 "07:34",
1040 0
1041 ],
1042 [
1043 "07:35",
1044 0
1045 ],
1046 [
1047 "07:36",
1048 0
1049 ]
1050 ]
1051 }
1052 }
1053 }
1054]
<Warning> You can only retrieve data traffic costs for organizations without multi-inclusive volumes. </Warning> Retrieves SIM usage and cost statistics for a given ID. Usage statistics are sorted by `data` and `sms`. Returns statistics from the following periods: * `last_month`: Previous billing month, from the first to last day (for example, February 1-29, 2024, when you send the request in March 2024). * `current_month`: Current month, with statistics calculated up to and including the date requested (for example, March 1-8, 2024, when you sent the request on March 8, 2024). * `last_hour`: Previous 60 minutes, accumulated per minute and organized by data or SMS received by the device (`rx`) and transmitted by the device (`tx`). <Info> `last_month` and `current_month` are only included in the responses if traffic exists. Those responses include a generated `id` value that's comprised of the SIM ID, year, month, and traffic type ID (`5` for data and `6` for SMS). For example, if you send a request in March 2024 for SIM ID `123456`, the `id` for data in the current month is `1234562024035`. </Info>
Was this page helpful?
Previous

Update a SIM

Next

Daily SIM usage statistics

Built with

You can only retrieve data traffic costs for organizations without multi-inclusive volumes.

Retrieves SIM usage and cost statistics for a given ID. Usage statistics are sorted by data and sms.

Returns statistics from the following periods:

  • last_month: Previous billing month, from the first to last day (for example, February 1-29, 2024, when you send the request in March 2024).
  • current_month: Current month, with statistics calculated up to and including the date requested (for example, March 1-8, 2024, when you sent the request on March 8, 2024).
  • last_hour: Previous 60 minutes, accumulated per minute and organized by data or SMS received by the device (rx) and transmitted by the device (tx).

last_month and current_month are only included in the responses if traffic exists. Those responses include a generated id value that’s comprised of the SIM ID, year, month, and traffic type ID (5 for data and 6 for SMS).

For example, if you send a request in March 2024 for SIM ID 123456, the id for data in the current month is 1234562024035.

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 SIM statistics associated with the provided id.

last_monthobject
current_monthobject
last_hourobject