Network Connection


In short, this endpoint is to check the device Internet connection. So why do you need that? As a fact, the devices may go offline sometimes. As an automation tester, of course you don’t want to execute any tests on an offline device if your test case requires Internet connection. This is where this API comes in handy.

How to use this endpoint


POST /v1/hub/device-health-check/network


The /network endpoint is only available on Private and Local devices. This endpoint does not support Kobiton public devices

Check a device Internet connection by letting that device ping to a domain.

Body parameters Type Required Description
deviceInfo object true  Information of the device
>udid string false  
>platformName string false  
>platformVersion string false  
domains [string] false An array of domains
timeout integer false The duration allowed to ping a domain in seconds



Status Meaning Description
200 OK Send API success. Return success message and status
400 Bad request Error syntax. Return message 'Unhandled path ...'
401 Unauthorized The credential you entered was not authorized




curl --location --request POST '' \ 
--header 'Content-Type: application/json' \
--header 'Authorization: {Your-authorization}' \
--data-raw '{
   "deviceInfo": {
        "platformName": "iOS",
        "platformVersion": "14.3",
        "udid": "{device-udid}"
"domains": [
   "timeout": 60


   "value": {
        "status": "Reachable",
        "ipAddress": "",
        "info": {
             "timeout": 60,
             "host": ""
        "usingProxy": false


This endpoint is able to check the Internet connection through Wifi only, not the cellular network.

Was this article helpful?
0 out of 0 found this helpful