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

Change the IMEI of one or more modems

Use this only when the user asks to change modem IMEIs. Option 1 uses IMEIs from imei_list (one per position in order when the counts match, otherwise random picks); option 2 generates an IMEI from a random TAC in phone_models; option 3 generates one from the first 8 digits of based_imei. Each changed modem reboots. Stops at the first modem that rejects the change. Positions without a modem are skipped and still reported as success, and errors inside the loop (for example option 1 without imei_list) are swallowed, so a success answer does not prove any IMEI changed.

  • Destructive · confirm first
  • Basic auth
  • Panel API · since v20.8.0
  • Hub: needs owner approval
  • changeImei
POST/v2/imei_change_in_bulk

Request body application/json · required

positionsinteger[]required
imei_changer_optionintegerrequired
One of 1, 2, 3
imei_liststringoptional

Option 1: text containing 15-digit IMEIs (any separator).

phone_modelsstring[]optional

Option 2: TAC codes of phone models.

based_imeistringoptional

Option 3: an IMEI or its first 8 digits.

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

Result.

statusbooleanrequired

True when the box accepted the request.

msgstringrequired

Outcome code or message (see the operation's error table).

Errors returned in msg

msgMeaningWhat to do
Please choice at least a brand/model!Option 2 with an empty phone_models list.Send at least one TAC.
Please fill valid IMEI!Option 3 with fewer than 8 digits in based_imei.Send at least the first 8 digits.
Sent change IMEI failed. Try again!A modem rejected the change; later positions were not processed.Check the modem type supports IMEI change and retry the remaining positions.
Verified against XProxy v21.3.2 on Nov 17, 2026