Retrieve connectivity information for an endpoint

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

Connectivity Info Subscriber False Responseobject

Connectivity Info Error Responseobject

1	import requests
2
3	url = "https://cdn.emnify.net/api/v1/endpoint/endpoint_id/connectivity_info"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

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	}

Authentication

Path parameters

Response

Errors