Retrieve connectivity information for an endpoint

GET

https://cdn.emnify.net/api/v1/endpoint/:endpoint_id/connectivity_info

Returns device location information based on the cell tower to which the device is connected. <Note> emnify validates the data requested, sends the signal request to the network operator, and interprets the response. Whether the network returns useful data is outside of emnify's control. To distinguish these cases, this call returns the HTTP `200 OK` response code whenever the request is successfully executed, even if it includes an error. See the response body for details. </Note>

Retrieve connectivity information for an endpoint

GET

https://cdn.emnify.net/api/v1/endpoint/:endpoint_id/connectivity_info

Returns device location information based on the cell tower to which the device is connected.

emnify validates the data requested, sends the signal request to the network operator, and interprets the response. Whether the network returns useful data is outside of emnify’s control.

To distinguish these cases, this call returns the HTTP 200 OK response code whenever the request is successfully executed, even if it includes an error. See the response body for details.

Returns device location information based on the cell tower to which the device is connected. <Note> emnify validates the data requested, sends the signal request to the network operator, and interprets the response. Whether the network returns useful data is outside of emnify's control. To distinguish these cases, this call returns the HTTP `200 OK` response code whenever the request is successfully executed, even if it includes an error. See the response body for details. </Note>

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

Response

Success

Connectivity Info Success Responseobject

OR

Connectivity Info Subscriber False Responseobject

OR

Connectivity Info Error Responseobject

Errors

404

Not Found Error

1	{
2	"subscriber_info": {
3	"success": true,
4	"state": "not_provided_from_vlr",
5	"location": {
6	"current_location_retrieved": false,
7	"age_of_location": 80,
8	"cell_global_id": {
9	"mcc": "262",
10	"mnc": "01",
11	"lac": 1234,
12	"cid": 1234
13	}
14	}
15	},
16	"request_timestamp": "2024-03-12T13:37:21.415Z",
17	"reply_timestamp": "2024-03-12T13:37:51.823Z"
18	}

1	{
2	"subscriber_info": {
3	"success": true,
4	"state": "not_provided_from_vlr",
5	"location": {
6	"current_location_retrieved": false,
7	"age_of_location": 80,
8	"cell_global_id": {
9	"mcc": "262",
10	"mnc": "01",
11	"lac": 1234,
12	"cid": 1234
13	}
14	}
15	},
16	"request_timestamp": "2024-03-12T13:37:21.415Z",
17	"reply_timestamp": "2024-03-12T13:37:51.823Z"
18	}

$	curl -G https://cdn.emnify.net/api/v1/endpoint/12345/connectivity_info \
>	-H "Authorization: Bearer <token>" \
>	-d subscriber=true