# Per-device Cell tower Plus

> For the complete documentation index, see [llms.txt](https://help.1nce.com/llms.txt).

## Prerequisites

- **Authentication** — Bearer token required. See [authorization flow](/api/authorization/authorization/).
- **Device Location Credits** — Active [Device Location Credits](/docs/1nce-os/1nce-os-device-locator/#device-location-credits) must be available in your account.
- **API rate limits** — Review the [rate limits](/api/api-rate-limits/) to avoid throttling.

## Understanding Cell tower Plus Modes

:::info Terminology
**Basic** and **Plus** are the two solver modes for Cell Tower Location. Basic is free. Plus is a paid upgrade (requires [Device Location Credits](/docs/1nce-os/1nce-os-device-locator/#device-location-credits)) offering higher accuracy for 3G/4G/LTE-M.

The **DEFAULT** and **CUSTOM** configurations described below apply only to the Plus solver mode.
:::

The `ADVANCED_CELL_TOWER_LOCATION` setting can be in one of the following states:

- **DEFAULT** — Cell tower Plus applies uniformly to all devices — cell tower location data is resolved no more frequently than once an hour. This is the initial mode when the feature is first enabled.
- **CUSTOM** — You control which devices have their network events processed with the Plus solver, and how frequently (60–1440 minutes). The frequency determines the minimum interval at which network events from a device are picked up for location resolution. All other devices fall back to basic resolution.

| Organization mode | Devices with frequency set | Other devices |
|---|---|---|
| **DEFAULT** | All devices: Plus resolution once per hour | All devices: Plus resolution once per hour |
| **CUSTOM** | Plus resolution at configured frequency | Basic resolution only (once per hour) |
| **Disabled (no purchased credits)** | Basic resolution only (once per hour) | Basic resolution only (once per hour) |

:::warning
Switching to CUSTOM mode is required before enabling or disabling Cell tower Plus on individual devices. Attempting per-device operations without CUSTOM mode active results in a **403 Forbidden** response.
:::

## Workflow

### Step 1 – Switch to CUSTOM Mode

Patch the `ADVANCED_CELL_TOWER_LOCATION` setting with `{"mode": "CUSTOM"}` to enable per-device configuration.

**Endpoint:** [`PATCH /v1/settings/1nceos/ADVANCED_CELL_TOWER_LOCATION/details`](/api/1nce-os/patch-setting-details/)

[API example](/docs/1nce-os/1nce-os-device-locator/device-locator-api/#switch-to-custom-mode)

### Step 2 – Enable Cell tower Plus for Devices

Enable Plus resolution for selected devices by providing their ICCIDs and a frequency value.

**Endpoint:** [`POST /v1/locate/devices/settings`](/api/1nce-os/enable-adl-device-location-settings/)

[API example](/docs/1nce-os/1nce-os-device-locator/device-locator-api/#enable-cell-tower-plus-for-devices)

### Step 3 – Query Per-Device Settings

Retrieve which devices have per-device Cell tower Plus enabled.

**Endpoint:** [`GET /v1/inspect/devices/settings/DEVICE_ADL`](/api/1nce-os/get-per-device-settings/)

[API example](/docs/1nce-os/1nce-os-device-locator/device-locator-api/#get-per-device-settings)

### Step 4 – Disable Cell tower Plus for Devices

Disable Plus resolution for selected devices.

**Endpoint:** [`DELETE /v1/locate/devices/settings`](/api/1nce-os/disable-adl-device-location-settings/)

[API example](/docs/1nce-os/1nce-os-device-locator/device-locator-api/#disable-cell-tower-plus-for-devices)

## Additional Behavior

- **New SIMs** — When a new SIM is activated in CUSTOM mode, it defaults to basic resolution. You must explicitly enable it via the POST endpoint.
- **Credits exhausted** — The system falls back to the Basic resolver. Mode and per-device configurations remain intact, and Plus resolution resumes automatically when credits are replenished.
- **Credit debt** — Deducted from the next batch of purchased credits.
- **Switching back to DEFAULT** — Not available via the API. Open a support ticket with 1NCE Support. When the switch is performed, all per-device frequency configurations are permanently removed.

## Related Resources

- [API Examples — Per-device Cell tower Plus](/docs/1nce-os/1nce-os-device-locator/device-locator-api/#per-device-cell-tower-plus)
- [Enable ADL Device Location Settings](/api/1nce-os/enable-adl-device-location-settings/) — API Explorer
- [Disable ADL Device Location Settings](/api/1nce-os/disable-adl-device-location-settings/) — API Explorer
- [Get Per-Device Settings](/api/1nce-os/get-per-device-settings/) — API Explorer
- [Patch Setting Details](/api/1nce-os/patch-setting-details/) — API Explorer
- [Device Locator overview](/docs/1nce-os/1nce-os-device-locator/)
- [API rate limits](/api/api-rate-limits/)