API reference

Mobile ports and IP rotation

Dedicated 4G/5G ports: change the IP now or on a timer, use the rotation link and read the daily traffic.

Last updated: October 14, 2026 · 8 min read

Endpoints on this page

GET /v1/mobile: List mobile ports
GET /v1/mobile/{portId}: Get a mobile port
PATCH /v1/mobile/{portId}: Rename, toggle auto-renew, or configure automatic rotation
POST /v1/mobile/{portId}/rotate: Change the IP now
GET /v1/mobile/{portId}/rotate: Rotation link (GET with API key in the query string)
POST /v1/mobile/{portId}/reset-password: Generate a new proxy password for the port
GET /v1/mobile/{portId}/usage: Daily traffic through the port (for information: unlimited data, under fair use)
GET /v1/catalog/countries/{countryCode}/carriers: Mobile carriers with available 4G/5G ports in a country

Base URL https://cellmast.com/api/v1. Authentication, errors and limits: see the API overview.

List mobile ports

GET/v1/mobile

Authentication: API key in the Authorization: Bearer API_KEY header.

Response `200 OK`

{
  "data": [
    {
      "id": "mob_2v8k1q",
      "label": "US AT&T #1",
      "status": "active",
      "country": "US",
      "city": null,
      "carrier": "att",
      "carrierName": "AT&T",
      "networkType": "4G",
      "currentIp": "203.0.113.201",
      "ipChangedAt": "2026-10-05T14:03:11Z",
      "endpoint": {
        "host": "gw.cellmast.com",
        "httpPort": 7777,
        "socksPort": 7778
      },
      "username": "USERNAME",
      "password": "PASSWORD",
      "rotation": {
        "mode": "interval",
        "intervalMinutes": 10
      },
      "minRotationIntervalSeconds": 30,
      "rotationLink": "https://cellmast.com/api/v1/mobile/mob_2v8k1q/rotate?key=API_KEY",
      "planId": "mob-us-30d",
      "autoRenew": false,
      "createdAt": "2026-10-05T14:03:11Z",
      "expiresAt": "2026-11-04T14:03:11Z"
    }
  ]
}

Code examples

curl

curl -s "https://cellmast.com/api/v1/mobile" \
  -H "Authorization: Bearer $API_KEY"

Python

import os
import requests

API = "https://cellmast.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.get(f"{API}/mobile", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())

Node.js

// Node.js 18+ (built-in fetch), ES module
const API = 'https://cellmast.com/api/v1';

const res = await fetch(`${API}/mobile`, {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Get a mobile port

GET/v1/mobile/{portId}

Authentication: API key in the Authorization: Bearer API_KEY header.

Parameters

Name	In	Type	Required	Description
`portId`	path	string	Yes	—

Response `200 OK`

{
  "id": "mob_2v8k1q",
  "label": "US AT&T #1",
  "status": "active",
  "country": "US",
  "city": null,
  "carrier": "att",
  "carrierName": "AT&T",
  "networkType": "4G",
  "currentIp": "203.0.113.201",
  "ipChangedAt": "2026-10-05T14:03:11Z",
  "endpoint": {
    "host": "gw.cellmast.com",
    "httpPort": 7777,
    "socksPort": 7778
  },
  "username": "USERNAME",
  "password": "PASSWORD",
  "rotation": {
    "mode": "interval",
    "intervalMinutes": 10
  },
  "minRotationIntervalSeconds": 30,
  "rotationLink": "https://cellmast.com/api/v1/mobile/mob_2v8k1q/rotate?key=API_KEY",
  "planId": "mob-us-30d",
  "autoRenew": false,
  "createdAt": "2026-10-05T14:03:11Z",
  "expiresAt": "2026-11-04T14:03:11Z"
}

Code examples

curl

curl -s "https://cellmast.com/api/v1/mobile/mob_2v8k1q" \
  -H "Authorization: Bearer $API_KEY"

Python

import os
import requests

API = "https://cellmast.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.get(f"{API}/mobile/mob_2v8k1q", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())

Node.js

// Node.js 18+ (built-in fetch), ES module
const API = 'https://cellmast.com/api/v1';

const res = await fetch(`${API}/mobile/mob_2v8k1q`, {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Rename, toggle auto-renew, or configure automatic rotation

PATCH/v1/mobile/{portId}

Rename the port, turn auto-renew on or off, or set an automatic rotation timer, from every 2 minutes to every 24 hours: "rotation": { "mode": "interval", "intervalMinutes": 10 } (2–1440 minutes); "mode": "manual" turns it off. Otherwise your port keeps its IP until you rotate it, although the carrier can change it on its own from time to time.

Authentication: API key in the Authorization: Bearer API_KEY header.

Parameters

Name	In	Type	Required	Description
`portId`	path	string	Yes	—

Request body

Field	Type	Required	Description
`label`	string	No	max. 60 characters
`autoRenew`	boolean	No	—
`rotation`	object	No	Automatic rotation timer: `{ "mode": "interval", "intervalMinutes": 2–1440 }` (from every 2 minutes to every 24 hours), or `{ "mode": "manual", "intervalMinutes": null }` to rotate only on demand.

Example: Auto Rotate

{
  "rotation": {
    "mode": "interval",
    "intervalMinutes": 10
  }
}

Example: Manual

{
  "rotation": {
    "mode": "manual",
    "intervalMinutes": null
  }
}

Response `200 OK`

{
  "id": "mob_2v8k1q",
  "label": "US AT&T #1",
  "status": "active",
  "country": "US",
  "city": null,
  "carrier": "att",
  "carrierName": "AT&T",
  "networkType": "4G",
  "currentIp": "203.0.113.201",
  "ipChangedAt": "2026-10-05T14:03:11Z",
  "endpoint": {
    "host": "gw.cellmast.com",
    "httpPort": 7777,
    "socksPort": 7778
  },
  "username": "USERNAME",
  "password": "PASSWORD",
  "rotation": {
    "mode": "interval",
    "intervalMinutes": 10
  },
  "minRotationIntervalSeconds": 30,
  "rotationLink": "https://cellmast.com/api/v1/mobile/mob_2v8k1q/rotate?key=API_KEY",
  "planId": "mob-us-30d",
  "autoRenew": false,
  "createdAt": "2026-10-05T14:03:11Z",
  "expiresAt": "2026-11-04T14:03:11Z"
}

Code examples

curl

curl -s -X PATCH "https://cellmast.com/api/v1/mobile/mob_2v8k1q" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rotation":{"mode":"interval","intervalMinutes":10}}'

Python

import os
import requests

API = "https://cellmast.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.patch(f"{API}/mobile/mob_2v8k1q", headers=HEADERS, json={"rotation": {"mode": "interval", "intervalMinutes": 10}}, timeout=30)
r.raise_for_status()
print(r.json())

Node.js

// Node.js 18+ (built-in fetch), ES module
const API = 'https://cellmast.com/api/v1';

const res = await fetch(`${API}/mobile/mob_2v8k1q`, {
  method: 'PATCH',
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ rotation: { mode: 'interval', intervalMinutes: 10 } }),
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Change the IP now

POST/v1/mobile/{portId}/rotate

Each rotation reconnects your port to the carrier to get a new IP and usually takes 5–15 seconds; the carrier may occasionally hand back the same IP: just rotate again. At most once every 30 seconds per port (minRotationIntervalSeconds): a rotation asked too soon returns 429 rotation_too_soon with Retry-After (seconds to wait).

Authentication: API key in the Authorization: Bearer API_KEY header.

Parameters

Name	In	Type	Required	Description
`portId`	path	string	Yes	—

Response `200 OK`

{
  "ip": "203.0.113.201",
  "previousIp": "203.0.113.77",
  "rotatedAt": "2026-10-05T14:03:11Z",
  "nextRotationAvailableAt": "2026-10-05T14:03:41Z"
}

Code examples

curl

curl -s -X POST "https://cellmast.com/api/v1/mobile/mob_2v8k1q/rotate" \
  -H "Authorization: Bearer $API_KEY"

Python

import os
import requests

API = "https://cellmast.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.post(f"{API}/mobile/mob_2v8k1q/rotate", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())

Node.js

// Node.js 18+ (built-in fetch), ES module
const API = 'https://cellmast.com/api/v1';

const res = await fetch(`${API}/mobile/mob_2v8k1q/rotate`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Rotation link (GET with API key in the query string)

GET/v1/mobile/{portId}/rotate

Same as POST, for scripts and bookmarks: GET https://cellmast.com/api/v1/mobile/{portId}/rotate?key=API_KEY. The key needs the proxies scope. format=text returns the new IP as text/plain.

Authentication: API key in the key query parameter (scope proxies), so the link works from a bookmark.

Parameters

Name	In	Type	Required	Description
`key`	query	string	Yes	Your API key (scope `proxies`).
`portId`	path	string	Yes	—
`format`	query	`json` · `text`	No	default `json`

Response `200 OK`

{
  "ip": "203.0.113.201",
  "previousIp": "203.0.113.77",
  "rotatedAt": "2026-10-05T14:03:11Z",
  "nextRotationAvailableAt": "2026-10-05T14:03:41Z"
}

Code examples

curl

curl -s "https://cellmast.com/api/v1/mobile/mob_2v8k1q/rotate?key=$API_KEY&format=text"

Python

import os
import requests

API = "https://cellmast.com/api/v1"

r = requests.get(f"{API}/mobile/mob_2v8k1q/rotate", params={"key": os.environ["API_KEY"], "format": "text"}, timeout=30)
r.raise_for_status()
print(r.text)

Node.js

// Node.js 18+ (built-in fetch), ES module
const API = 'https://cellmast.com/api/v1';

const res = await fetch(`${API}/mobile/mob_2v8k1q/rotate?key=${process.env.API_KEY}&format=text`);
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.text());

Generate a new proxy password for the port

POST/v1/mobile/{portId}/reset-password

Authentication: API key in the Authorization: Bearer API_KEY header.

Parameters

Name	In	Type	Required	Description
`portId`	path	string	Yes	—

Response `200 OK`

{
  "id": "mob_2v8k1q",
  "label": "US AT&T #1",
  "status": "active",
  "country": "US",
  "city": null,
  "carrier": "att",
  "carrierName": "AT&T",
  "networkType": "4G",
  "currentIp": "203.0.113.201",
  "ipChangedAt": "2026-10-05T14:03:11Z",
  "endpoint": {
    "host": "gw.cellmast.com",
    "httpPort": 7777,
    "socksPort": 7778
  },
  "username": "USERNAME",
  "password": "PASSWORD",
  "rotation": {
    "mode": "interval",
    "intervalMinutes": 10
  },
  "minRotationIntervalSeconds": 30,
  "rotationLink": "https://cellmast.com/api/v1/mobile/mob_2v8k1q/rotate?key=API_KEY",
  "planId": "mob-us-30d",
  "autoRenew": false,
  "createdAt": "2026-10-05T14:03:11Z",
  "expiresAt": "2026-11-04T14:03:11Z"
}

Code examples

curl

curl -s -X POST "https://cellmast.com/api/v1/mobile/mob_2v8k1q/reset-password" \
  -H "Authorization: Bearer $API_KEY"

Python

import os
import requests

API = "https://cellmast.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.post(f"{API}/mobile/mob_2v8k1q/reset-password", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())

Node.js

// Node.js 18+ (built-in fetch), ES module
const API = 'https://cellmast.com/api/v1';

const res = await fetch(`${API}/mobile/mob_2v8k1q/reset-password`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Daily traffic through the port (for information: unlimited data, under fair use)

GET/v1/mobile/{portId}/usage

For information only. Unlimited data on your dedicated port, under fair use: the carrier may slow or pause very heavy use.

Authentication: API key in the Authorization: Bearer API_KEY header.

Parameters

Name	In	Type	Required	Description
`portId`	path	string	Yes	—
`from`	query	string (date)	No	First day (UTC), inclusive. Default = 29 days before `to`.
`to`	query	string (date)	No	Last day (UTC), inclusive. Default = today. Maximum range 366 days.

Response `200 OK`

{
  "from": "2026-10-04",
  "to": "2026-10-05",
  "totalBytes": 2350000000,
  "totalRequests": 48210,
  "points": [
    {
      "date": "2026-10-04",
      "bytes": 1200000000,
      "requests": 24800
    },
    {
      "date": "2026-10-05",
      "bytes": 1150000000,
      "requests": 23410
    }
  ],
  "byCountry": [
    {
      "country": "US",
      "bytes": 2350000000
    }
  ]
}

Code examples

curl

curl -s "https://cellmast.com/api/v1/mobile/mob_2v8k1q/usage" \
  -H "Authorization: Bearer $API_KEY"

Python

import os
import requests

API = "https://cellmast.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.get(f"{API}/mobile/mob_2v8k1q/usage", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())

Node.js

// Node.js 18+ (built-in fetch), ES module
const API = 'https://cellmast.com/api/v1';

const res = await fetch(`${API}/mobile/mob_2v8k1q/usage`, {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Mobile carriers with available 4G/5G ports in a country

GET/v1/catalog/countries/{countryCode}/carriers

Public: no API key needed.

Parameters

Name	In	Type	Required	Description
`countryCode`	path	string	Yes	ISO 3166-1 alpha-2, upper case.

Response `200 OK`

{
  "data": [
    {
      "id": "att",
      "name": "AT&T",
      "networkTypes": [
        "4G",
        "5G"
      ],
      "available": true,
      "cities": []
    }
  ]
}

Code examples

curl

curl -s "https://cellmast.com/api/v1/catalog/countries/US/carriers"

Python

import os
import requests

API = "https://cellmast.com/api/v1"

r = requests.get(f"{API}/catalog/countries/US/carriers", timeout=30)
r.raise_for_status()
print(r.json())

Node.js

// Node.js 18+ (built-in fetch), ES module
const API = 'https://cellmast.com/api/v1';

const res = await fetch(`${API}/catalog/countries/US/carriers`);
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

List mobile ports

Response 200 OK

Code examples

Get a mobile port

Parameters

Response 200 OK

Code examples

Rename, toggle auto-renew, or configure automatic rotation

Parameters

Request body

Response 200 OK

Code examples

Change the IP now

Parameters

Response 200 OK

Code examples

Rotation link (GET with API key in the query string)

Parameters

Response 200 OK

Code examples

Generate a new proxy password for the port

Parameters

Response 200 OK

Code examples

Daily traffic through the port (for information: unlimited data, under fair use)

Parameters

Response 200 OK

Code examples

Mobile carriers with available 4G/5G ports in a country

Parameters

Response 200 OK

Code examples

Related pages

Response `200 OK`

Response `200 OK`

Response `200 OK`

Response `200 OK`

Response `200 OK`

Response `200 OK`

Response `200 OK`

Response `200 OK`