iProxy Connection API

Prerequisites

---

Connection control

1. Get connection

curl --request GET \
--header "Authorization: Bearer <conn_api_key>" \
--url https:/iproxy.online/api/cn/v1/

{
  "id": "{conn_id}",
  "basic_info": {
    "name": "online connection",
    "description": "connection_description (optional)",
    "created_at": "2025-07-11T10:36:38.006Z",
    "updated_at": "2025-07-11T10:58:51.42Z",
    "server_geo": {
      "country": "pl",
      "city": "waw"
    },
    "is_onboarding": false,
    "user_id": "myOrOwnerUserId",
    "server_id": "someServerId"
  },
  "shared_users": [],
  "plan_info": {
    "active_plan": {
      "id": "nlUs1D8PKL",
      "started_at": "2025-07-11T10:55:10.913Z",
      "expires_at": "2025-08-10T10:55:10.913Z"
    }
  },
  "settings": {
    "prolongation_enabled": false,
    "dns": [],
    "telegram_change_ip_notification_enabled": false,
    "telegram_status_notification_enabled": true,
    "reboot_cron_string": "",
    "low_battery_reboot_threshold": 0,
    "no_network_reboot_timeout_seconds": 0,
    "ip_change_airplane_mode_time_seconds": 0,
    "no_network_airplane_toggle_timeout_seconds": 0,
    "tariff_notify_hours_before_expired": [],
    "no_wifi_inet_disable_wifi_timeout_seconds": 0,
    "no_wifi_connection_reboot_timeout_seconds": 0,
    "tcp_fingerprint": "",
    "ip_change_wait_unique": false,
    "ip_change_wait_unique_attempts": 0,
    "ip_change_wait_unique_lookbehind_minutes": 0,
    "ip_change_enabled": false,
    "ip_change_interval_minutes": 0,
    "macros_url": "",
    "app_restart_interval_minutes": 0,
    "connection_refresh_interval_minutes": 0
  },
  "app_data": {
    "device_info": {
      "is_root": false,
      "manufacturer": "Samsung",
      "model": "SM-A236B",
      "android_version": "14",
      "system_fingerprint": "6e1334d2",
      "system_device_id": "397ff68",
      "voice_assist_configured": true,
      "mobile_data_always_on": true,
      "owner_mode_enabled": false
    },
    "app_id": "com.iproxy.android",
    "app_version": "574",
    "app_version_patch": "1",
    "build_number": "57401",
    "agent_setup_complete": false,
    "ready_to_change_ip": true,
    "wifi_split_enabled": false,
    "last_activity_at": "2025-07-11T10:58:51.417Z",
    "installation_id": "phone-9da94533-e175-42a5-bdcb-f80b4c621117"
  }
}

2. Update connection basic info

curl --request POST \
--header "Authorization: Bearer <conn_api_key>" \
--header 'Content-Type: application/json' \
--url https:/iproxy.online/api/cn/v1/update-basic-info \
-d '{
  "name": "new_name",
  "description": "new_description"
}'

{
    "id": "connection_id",
    "name": "new_name",
    "description": "new_description"
}

3. Update connection settings

curl --request POST \
--header "Authorization: Bearer <conn_api_key>" \
--header 'Content-Type: application/json' \
--url https:/iproxy.online/api/cn/v1/update-settings \
-d '{
    "prolongation_enabled": false,
    "dns": ["1.1.1.1"],
    "telegram_change_ip_notification_enabled": false,
    "telegram_status_notification_enabled": true,
    "reboot_cron_string": "30 */3 * * *",
    "low_battery_reboot_threshold": 0,
    "no_network_reboot_timeout_seconds": 0,
    "ip_change_airplane_mode_time_seconds": 0,
    "no_network_airplane_toggle_timeout_seconds": 0,
    "tariff_notify_hours_before_expired": [2, 12, 48],
    "no_wifi_inet_disable_wifi_timeout_seconds": 0,
    "no_wifi_connection_reboot_timeout_seconds": 0,
    "tcp_fingerprint": "Win10",
    "ip_change_wait_unique": false,
    "ip_change_wait_unique_attempts": 0,
    "ip_change_wait_unique_lookbehind_minutes": 0,
    "ip_change_enabled": false,
    "ip_change_interval_minutes": 0,
    "macros_url": "https:/example.com",
    "app_restart_interval_minutes": 0,
    "connection_refresh_interval_minutes": 0
}'

You only need to send the fields you want to update. The current values of the fields can be retrieved via a GET request.

{
  "id": "{conn_id}",
  "prolongation_enabled": false,
  "dns": ["1.1.1.1"],
  "telegram_change_ip_notification_enabled": false,
  "telegram_status_notification_enabled": true,
  "reboot_cron_string": "30 */3 * * *",
  "low_battery_reboot_threshold": 0,
  "no_network_reboot_timeout_seconds": 0,
  "ip_change_airplane_mode_time_seconds": 0,
  "no_network_airplane_toggle_timeout_seconds": 0,
  "tariff_notify_hours_before_expired": [
    2,
    12,
    48
  ],
  "no_wifi_inet_disable_wifi_timeout_seconds": 0,
  "no_wifi_connection_reboot_timeout_seconds": 0,
  "tcp_fingerprint": "Win10",
  "ip_change_wait_unique": false,
  "ip_change_wait_unique_attempts": 0,
  "ip_change_wait_unique_lookbehind_minutes": 0,
  "ip_change_enabled": false,
  "ip_change_interval_minutes": 0,
  "macros_url": "https:/example.com",
  "app_restart_interval_minutes": 0,
  "connection_refresh_interval_minutes": 0
}

4. Modify team access

curl --request POST \
--header "Authorization: Bearer <conn_api_key>" \
--header 'Content-Type: application/json' \
--url https:/iproxy.online/api/cn/v1/team-access/modify \
-d '{
  "email": "[email protected]",
    "permissions": {
    "action_link_create": true,
    "action_link_remove": true,
    "airplane_mode_time_edit": true
  }
}'

{
  "email": "[email protected]",
  "permissions": {
    "airplane_mode_time_edit": false,
    "authorization_pin_create": false,
    "battery_level_threshold": false,
    "connection_change_tariff": false,
    "connection_payment": false,
    "connection_remove": false,
    "description_edit": false,
    "dns_setting": false,
    "enable_unique_ip": false,
    "find_device": false,
    "fix_lte": false,
    "ip_history_view": false,
    "logs_download": false,
    "macros_url": false,
    "name_edit": false,
    "open_vpn_create": false,
    "open_vpn_view": false,
    "open_vpn_edit": false,
    "open_vpn_remove": false,
    "pof_setting": false,
    "no_network_reboot": false,
    "proxy_create": false,
    "proxy_edit": false,
    "proxy_remove": false,
    "proxy_view": false,
    "reboot_device": false,
    "repeating_ip_view": false,
    "rotation_setting": false,
    "scheduled_reboot": false,
    "sms_control": false,
    "tariff_statistic_view": false,
    "no_network_airplane_toggle_time_edit": false,
    "uptime_view": false,
    "url_change_ip_create": false,
    "url_change_ip_remove": false,
    "team_members_edit": false,
    "api_key_create": false,
    "action_link_create": true,
    "action_link_view": false,
    "action_link_remove": true,
    "basic_info_edit": false,
    "settings_edit": false,
    "connection_control": false
  }
}

5. Remove team access

curl --request POST \
--header "Authorization: Bearer <conn_api_key>" \
--header 'Content-Type: application/json' \
--url https:/iproxy.online/api/cn/v1/team-access/remove \
-d '{
  "email": "[email protected]"
}'

{
    "email": "[email protected]"
}

6. Change connection tariff

curl --request POST \
--header "Authorization: Bearer <conn_api_key>" \
--header 'Content-Type: application/json' \
--url https:/iproxy.online/api/cn/v1/change-plan \
-d '{
  "plan_id": "M7Fq2RKexi"
}'

{
  "active_plan": {
    "id": "M7Fq2RKexi",
    "started_at": "2025-07-11T10:55:10.913Z",
    "expires_at": "2025-08-10T10:55:10.913Z"
  }
}

7. Get last 100 sms

curl --request GET \
--header "Authorization: Bearer <conn_api_key>" \
--url https:/iproxy.online/api/cn/v1/sms-history

{
  "sms_messages": [
    {
      "id": "sms_id",
      "message": "Example message",
      "from": "Somebody",
      "from_contact": "Mike (may be empty)",
      "created_at": "2025-06-01T04:24:48Z"
    }
  ]
}

8. Command push

curl --request POST \
--url https://iproxy.online/api/console/v1/connection/{connection_id}/command-push
--header 'Authorization: Bearer <conn_api_key>'
-d '{"action":"<command_name>", "<command_name>_params": {}}'

• refresh_fingerprint
• refresh
• reboot
• changeip
• fix_lte
• toggle_proxy
• find_my_device
• debug_report
• upgrade_app

• toggle_proxy_params:
  • enabled: bool

{"message": "{action} command has been sent"}

Connection API key and PIN code

1. Generate new connection PIN code

curl --request POST \
--header "Authorization: Bearer <conn_api_key>" \
--url https:/iproxy.online/api/cn/v1/pin-code

{
  "pincode": "<generated pin>",
  "expires_at": "2025-05-05T05:05:05Z"
}

expires_at is an RFC 3339 timestamp

---

Proxy access control

1. Create proxy access

{
  "listen_service": "http",  // http or socks5
  "auth_type": "userpass",  // userpass or noauth
  "auth": { // optional, will be generated
    "login": "proxy_login",
    "password": "proxy_pass"
  },
  "description": "new proxy description",
  "acl_inbound_policy": "deny_except", // optional, required only if auth_type: noauth
  "acl_inbound_ips": ["127.0.0.1"],    // optional IP ACL, non-empty; required only if acl_inbound_policy is set
  "expires_at": "2026-01-01T01:01:01Z" // optional date of proxy expiry
}

curl --request POST \
--header "Authorization: Bearer <conn_api_key>" \
--header 'Content-Type: application/json' \
--url https://iproxy.online/api/cn/v1/proxy-access \
-d '{
"listen_service": "socks5",
"auth_type": "userpass",
"description": "new proxy description"
}'

{
  "id": "2CiQPfoWcJ",
  "connection_id": "2W1IlyssyF",
  "description": "new proxy description",
  "listen_service": "socks5",
  "auth_type": "userpass",
  "auth": {
    "login": "username",
    "password": "superpassword"
  },
  "ip": "1.2.3.4",
  "port": 13874,
  "hostname": "x1.fxdx.in",
  "password_updated_at": "2025-07-11T18:05:18.622Z"
}

2. Update proxy access

{
  "listen_service": "http",  // http or socks5
  "auth_type": "userpass",  // userpass or noauth
  "auth": {
    "login": "new_login",
    "password": "new_pass"
  },
  "description": "new proxy description",
  "acl_inbound_ips": [],  // allowed IPs, set '[]' to disable
  "expires_at": "2026-01-01T01:01:01Z"  // date of proxy expiry, set '0001-01-01T00:00:00Z' to disable
}

all fields are optional, only set fields are updated

curl --request POST \
--header "Authorization: Bearer <conn_api_key>" \
--header 'Content-Type: application/json' \
--url https://iproxy.online/api/cn/v1/proxy-access/{proxy_id}/update \
-d '{
"listen_service": "http",
"auth_type": "userpass",
"auth": {
  "login": "new_login",
  "password": "new_pass"
},
"description": "new description",
"acl_inbound_ips": [],
"expires_at": "0001-01-01T00:00:00Z"
}'

{
  "id": "k31kcls",
  "connection_id": "ksdfmw343",
  "description": "new description",
  "listen_service": "http",
  "auth_type": "userpass",
  "auth": {
    "login": "new_login",
    "password": "new_pass"
  },
  "ip": "1.2.3.4",
  "port": 13872,
  "hostname": "x1.fxdx.in",
  "password_updated_at": "2025-07-11T16:55:21.37Z"
}

3. List proxy accesses by connection

curl --request GET \
--header "Authorization: Bearer <conn_api_key>" \
--url https://iproxy.online/api/cn/v1/proxy-access

{
  "proxy_accesses": [
    {
      "id": "2CiQPfoWcJ",
      "connection_id": "2W1IlyssyF",
      "description": "new proxy description",
      "listen_service": "socks5",
      "auth_type": "userpass",
      "auth": {
        "login": "user",
        "password": "pass"
      },
      "ip": "1.2.3.4",
      "port": 13874,
      "hostname": "x1.fxdx.in",
      "password_updated_at": "2025-07-11T18:05:18.622Z"
    },
    {
      "id": "HjttgsJjG3",
      "connection_id": "2W1IlyssyF",
      "description": "new description",
      "listen_service": "http",
      "auth_type": "userpass",
      "auth": {
        "login": "new_login",
        "password": "new_pass"
      },
      "acl_inbound_policy": "deny_except",
      "acl_inbound_ips": ["1.2.3.4"],
      "ip": "3.2.1.0",
      "port": 13875,
      "hostname": "x1.fxdx.in",
      "password_updated_at": "2025-07-11T18:07:35.919Z"
    }
  ]
}

4. Delete proxy access

curl --request DELETE \
--header "Authorization: Bearer <conn_api_key>" \
--url https://iproxy.online/api/cn/v1/proxy-access/{proxy_id}

{
  "id": "4cbI8O21Rd"
}

---

OpenVPN access api

1. Create OpenVPN access

{
  "name": "new VPN name",
  "description": "new VPN description",
}

curl --request POST \
--header "Authorization: Bearer <conn_api_key>" \
--url https://iproxy.online/api/cn/v1/ovpn-access \
-d '{
  "name": "new VPN name",
  "description": "new VPN description"
}'

{
  "status": "active",
  "name": "new VPN name",
  "description": "new VPN description",
  "expires_at": "2045-07-06T18:23:09.787673959Z",
  "dns": [],
  "id": "1InLOU8GWR",
  "connection_id": "{conn_id}"
}

2. List VPN accesses

curl --request GET \
--header "Authorization: Bearer <conn_api_key>" \
--url https://iproxy.online/api/cn/v1/ovpn-access

{
  "ovpn_accesses": [{
    "name": "VPN name",
    "description": "VPN description",
    "status": "active",
    "dns": [],
    "id": "ovpn_id",
    "connection_id": "{conn_id}",
    "expires_at": "2026-01-01T01:01:01Z"
  }]
}

4. Update VPN access

{
  "name": "VPN name",
  "description": "VPN description",
  "expires_at": "2026-01-01T01:01:01Z"
}

All fields are optional, only set fields are updated

curl --request POST \
--header "Authorization: Bearer <conn_api_key>" \
--header 'Content-Type: application/json' \
--url https://iproxy.online/api/cn/v1/ovpn-access/{ovpn_id}/update \
-d '{
    "name": "VPN name",
    "description": "VPN description",
    "expires_at": "2026-01-01T01:01:01Z"
}'

{
    "name": "VPN name",
    "description": "VPN description",
    "status": "active",
    "dns": [],
    "id": "ovpn_id",
    "connection_id": "{conn_id}",
    "expires_at": "2026-01-01T01:01:01Z"
}

5. Delete VPN access

curl --request DELETE \
--header "Authorization: Bearer <conn_api_key>" \
--url https://iproxy.online/api/cn/v1/ovpn-access/{ovpn_id}

{
    "id": "ovpn_id"
}

---

Connection statistics API

1. Daily traffic details.

curl --request GET \
--header "Authorization: Bearer <conn_api_key>" \
--url 'https://iproxy.online/api/cn/v1/traffic/by-day?from=2025-07-01T00%3A00%3A00Z&to=2025-08-01T03%3A00%3A00%2B03%3A00&timezone=Europe/Lisbon'

{
  "total_in_bytes": 1300000, // Inbound traffic in bytes
  "total_out_bytes": 1000000, // Outbound traffic in bytes
  "daily_stats": [{
    "date": "2025-03-31T00:00:00Z",
    "in_bytes": 1000,  // Inbound traffic for the day in bytes
    "out_bytes": 1000,  // Outbound traffic for the day in bytes
  }]
}

2. Hourly traffic details by port

curl --request GET \
--header "Authorization: Bearer <conn_api_key>" \
--url 'https://iproxy.online/api/cn/v1/traffic/by-hour-port?from=2025-07-01T00%3A00%3A00Z&to=2025-08-02T03%3A00%3A00%2B03%3A00'

{
  "port_stats": [{
    "port": "20314",
    "total_in_bytes": 1300000, // Inbound traffic in bytes
    "total_out_bytes": 1000000, // Outbound traffic in bytes
    "hourly_stats": [{
      "date": "2025-03-01T14:00:00Z",
      "in_bytes": 1000,  // Inbound traffic for the hour in bytes
      "out_bytes": 1000,  // Outbound traffic for the hour in bytes
  }]
}

3. Uptime statistics

curl --request GET \
--header "Authorization: Bearer <conn_api_key>" \
--url 'https://iproxy.online/api/cn/v1/uptime?from=2025-07-01T00%3A00%3A00Z&to=2025-08-02T03%3A00%3A00%2B03%3A00'

{
  "uptime": [{
    "date": "2025-03-01T14:00:00Z",
    "status": "UP"
  ]}
}

4. IP history

curl --request GET \
--header "Authorization: Bearer <conn_api_key>" \
--url 'https://iproxy.online/api/cn/v1/ip-history?from=2025-03-01T00%3A00%3A00Z&to=2025-03-02T03%3A00%3A00%2B03%3A00'

{
  "ip_history": [{
    "date": "2025-03-01T14:00:00Z",
    "ipv4": "127.0.0.1",
    "ipv6": "::1"
  ]}
}

---

Action links API

1. Create Action Link

curl --request POST \
--header "Authorization: Bearer <conn_api_key>" \
--header 'Content-Type: application/json' \
--url https://iproxy.online/api/cn/v1/actionlinks \
-d '{"action": "changeip", "comment": "link for client AAAA"}'

{
    "id": "xyzXYZ"
}

2. Get List of Action Links

curl --request GET \
--header "Authorization: Bearer <conn_api_key>" \
--url https://iproxy.online/api/cn/v1/actionlinks

{
    "action_links": [{
        "id": "xyzXYZ",
        "link": "https://i.fxdx.in/actionlinks/do/reboot/xyzXYZ",
        "action": "changeip",
        "connection_id": "abcdABCD",
        "comment": "link for client AAAA",
        "created_at": "2025-03-19T13:06:30Z"
    }]
}

3. Delete Action Link

curl --request DELETE \
--header "Authorization: Bearer <conn_api_key>" \
--url https://iproxy.online/api/cn/v1/actionlinks/{link_id}

{
    "id": "xyzXYZ"
}

4. Execute Action Link

• No authentication needed, don't share to unknown persons
• It's a simple GET request, be careful with the reboot action!

curl --request GET \
--url https://i.fxdx.in/actionlinks/do/{action}/{link_id}

{
    "message": "{action} command has been sent"
}