Retrieve daily usage statistics for an endpoint

GET

https://cdn.emnify.net/api/v1/endpoint/:endpoint_id/stats/daily

GET

/api/v1/endpoint/:endpoint_id/stats/daily

$ curl https://cdn.emnify.net/api/v1/endpoint/123/stats/daily \
>      -H "Authorization: Bearer <token>"

200Default - Current Month

1 [
2   {
3     "date": "2019-03-26",
4     "data": {
5       "volume": "0",
6       "volume_tx": "0",
7       "volume_rx": "0",
8       "cost": "0"
9     },
10     "sms": {
11       "volume": "0",
12       "volume_tx": "0",
13       "volume_rx": "0",
14       "cost": "0"
15     }
16   },
17   {
18     "date": "2019-03-25",
19     "data": {
20       "volume": "0.632622",
21       "volume_tx": "0.184861",
22       "volume_rx": "0.447761",
23       "traffic_type": {
24         "id": 5,
25         "description": "Data",
26         "unit": "MB"
27       },
28       "cost": "0.1265244000"
29     },
30     "sms": {
31       "volume": "0",
32       "volume_tx": "0",
33       "volume_rx": "0",
34       "cost": "0"
35     }
36   }
37 ]

Returns daily usage statistics for a specific endpoint, including cellular data and SMS volumes. By default, returns statistics for the current month. Use `start_date` and `end_date` query parameters to specify a custom date range. <Warning> Data traffic cost statistics (`cost` field in the `data` object) have been deprecated. </Warning>

Returns daily usage statistics for a specific endpoint, including cellular data and SMS volumes.

By default, returns statistics for the current month. Use start_date and end_date query parameters to specify a custom date range.

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

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

endpoint_idstringRequired

Query parameters

start_datestringOptionalformat: "date"

Filters by start date, provided in a `YYYY-MM-DD` format. <Info> If you don't define an end date, the response will include 6 months of data, beginning on the current date. </Info>

end_datestringOptionalformat: "date"

Filters by end date, provided in an `YYYY-MM-DD` format. <Info> If you don't define a start date, the response will only return data from the month indicated in your end date. </Info>

Response

Successfully returned the daily endpoint statistics. Each day's entry contains: - `date`: The date in YYYY-MM-DD format - `data`: Cellular data usage (volume in MB) - `sms`: SMS usage (volume as message count) - `sat_geo_data`: Satellite data usage, if applicable - `sat_geo_sms`: Satellite SMS usage, if applicable Volume fields include `volume` (total), `volume_tx` (transmitted), and `volume_rx` (received).

datestringformat: "date"

The date for this statistics entry (YYYY-MM-DD format).

dataobject

Cellular data usage for this day.

smsobject

SMS usage for this day.

sat_geo_dataobject

Satellite data usage for this day (if applicable).

sat_geo_smsobject

Satellite SMS usage for this day (if applicable).

$	curl https://cdn.emnify.net/api/v1/endpoint/123/stats/daily \
>	-H "Authorization: Bearer <token>"

1	[
2	{
3	"date": "2019-03-26",
4	"data": {
5	"volume": "0",
6	"volume_tx": "0",
7	"volume_rx": "0",
8	"cost": "0"
9	},
10	"sms": {
11	"volume": "0",
12	"volume_tx": "0",
13	"volume_rx": "0",
14	"cost": "0"
15	}
16	},
17	{
18	"date": "2019-03-25",
19	"data": {
20	"volume": "0.632622",
21	"volume_tx": "0.184861",
22	"volume_rx": "0.447761",
23	"traffic_type": {
24	"id": 5,
25	"description": "Data",
26	"unit": "MB"
27	},
28	"cost": "0.1265244000"
29	},
30	"sms": {
31	"volume": "0",
32	"volume_tx": "0",
33	"volume_rx": "0",
34	"cost": "0"
35	}
36	}
37	]