API Reference
Dashboard
  1. API Reference
  2. Box API
  3. Modems

Read the network mode and band lock a Huawei Hilink modem uses now

Use this to check the current band lock. Works only for HW-Hilink modems; others return Dongle do not support! or null data. The position is read from a JSON request body even though the method is GET.

  • Read only
  • Basic auth
  • Panel API · since v20.8.0
  • Hub: routine call
  • getCurrentBand
GET/current_band

Request body application/json · required

Must be sent as a JSON body with Content-Type application/json.

positionintegerrequired

Slot number (position) on the box, starting at 1. A missing or non-integer value makes the box answer HTTP 500.

Authentication

Needs dashboard Basic credentials when dashboard authentication is enabled; trusted callers (loopback, LAN unless "force auth for local" is on, whitelisted IP, allowed Tailscale) pass without them.

Responses

Current mode or a refusal.

statusbooleanrequired

False when the body was missing, the slot is empty, or the modem call raised an error.

dataobject | string | nullrequired

Modem answer.

Errors returned in msg

msgMeaningWhat to do
Dongle do not support!(in data) The modem is not a Huawei Hilink.Use the panel tools of that modem type.
(data empty, status false) No JSON body, empty slot, or the modem did not answer.Send position in a JSON body and check the modem is online.
Verified against XProxy v21.3.2 on Nov 17, 2026