# Endpoints Manage individual SIM cards and eSIMs provisioned on your Stacuity account. An **Endpoint** represents a **physical** device that has a single SIM card (physical or eSIM) on your account. It is the smallest unit of connectivity managed in the portal. Every endpoint has: * An **ICCID** — the permanent, globally unique identifier printed on the SIM card or encoded in the eSIM. This never changes. * One or more **IMSIs** — the network identities used when the device attaches to a mobile network. A single SIM can carry multiple IMSIs (for example, a multi-IMSI eSIM that can roam across different networks). The portal treats the endpoint as one logical unit regardless of how many IMSIs it holds. * A **lifecycle state** — the endpoint's current operational status (see below) * An optional **Name**, **Tags**, and **Reference** — for your own identification and filtering An endpoint on its own cannot pass traffic. It must be assigned to an [Endpoint Group](../02-endpoint-groups/endpoint-groups.md) to receive a network configuration and become active. > **Vantiq Motors — Example** > > Vantiq Connect manages eSIMs embedded in connected passenger vehicles at the point of manufacture. Each vehicle leaving the factory has a single eSIM — one endpoint in the portal. It arrives as **Pending**: allocated to the Vantiq Connect account, but not yet configured. The moment a vehicle is commissioned and its eSIM is assigned to the `vantiq-connect-eu` group, it becomes **Active** and the vehicle begins sending telematics data and receiving OTA software updates automatically. *** ## Endpoint Lifecycle States Every endpoint is always in exactly one of the following states. The state determines whether the endpoint can pass traffic and what actions are available on it. | State | What it means | Can pass traffic? | Reversible? | | -------------- | ---------------------------------------------------------- | ----------------- | ------------------------------------------- | | **Pending** | Allocated to your account, not yet in a group | No | Yes, assign to a group | | **Active** | In a group, fully provisioned, able to pass data | Yes | Yes, suspend or terminate | | **Idle** | Active, attached to a network, but no current data session | No active session | Yes, device will create session when ready | | **Detached** | Active, but not seen on any mobile network | No | Yes, device will re-attach when in coverage | | **Suspended** | Temporarily disabled. Any active session ends immediately | No | No | | **Terminated** | Permanently disabled | No | No, requires support ticket within 90 days | ### State transitions ``` [Tenant allocates SIM] │ ▼ Pending ──────────────────────────────────┐ │ │ [Assign to group] │ │ │ ▼ │ Active Suspended │ │ │ │ │ │ │ └──────────┬──────────────┘ │ │ │ [Terminate] [Terminate] │ │ ▼ │ Terminated ◄────────────────────┘ ``` **On Termination:** Termination cannot be undone through the portal. The endpoint record is retained for 90 days, during which Stacuity support can attempt reinstatement if contacted. After 90 days, the record is deleted permanently. Always double-check before terminating, especially when bulk-acting on large numbers of endpoints. *** ![](https://files.readme.io/34db7ec9f5245e582543afee32211b8ad6a33172941d9dd1e8d72b31d2b9b28a-image.png) ## Where to Find Endpoints Navigate to **Inventory → Endpoints**. The list shows all endpoints on your account. Each row displays the ICCID, name (if set), current state, assigned Endpoint Group, and last activity time. **Filtering and search:** | Filter | Use it to | | -------------- | ------------------------------------------ | | Status | Show only Active, Pending, Suspended, etc. | | Endpoint Group | Show all endpoints in a specific group | | Tag | Filter by a tag you have applied | | Search | Find by ICCID, name, or reference | *** ## Actions From the Endpoints list you can: | Action | How | Notes | | ------------------- | ------------------------------------------------------- | ----------------------------------------------- | | **View details** | Click the view icon or the ICCID | Opens the full endpoint detail view | | **Edit** | Click the ![edit](images/icons/edit-icon.png) edit icon | Update name, tags, static IP, IMEI lock | | **Assign to group** | Tick one or more checkboxes → Assign to Group | Moves selected endpoints from Pending to Active | | **Suspend** | Actions menu on the detail view | Blocks traffic immediately | | **Terminate** | Actions menu on the detail view | Irreversible — confirm carefully | Suspend and Terminate can also be applied to **multiple endpoints at once** by selecting them with the checkboxes before opening the Actions menu. *** ## IP Addresses Every active endpoint has at least one IP address, allocated from the subnet of its Endpoint Group's VSlice. The IP is shown on the endpoint's **IP Addresses** tab. If an endpoint is a member of a **Primary** Endpoint Group and one or more **Secondary** Endpoint Groups (used in [multi-APN deployments](../../03-configuration/07-multi-apn/multi-apn.md)), it will have one IP address per group membership — each used when the device sends traffic over the corresponding APN. IP addresses can be: * **Automatically assigned** — the next available IP from the subnet is allocated when the endpoint first creates a data session * **Statically assigned** — you specify a fixed IP in the endpoint's edit screen. That IP is permanently reserved for this endpoint. *** ## Related pages * [View an Endpoint](view-endpoints/view-endpoints.md) * [Edit an Endpoint](edit-endpoints.md) * [Assign Endpoints to a Group](assign-endpoints.md) * [Endpoint Groups](../02-endpoint-groups/endpoint-groups.md) * [Activate SIMs](../03-activate-sims/activate-sims.md) * [Multi-APN Support](../../03-configuration/07-multi-apn/multi-apn.md)