# UE Connections

A UE connection is a UE-associated logical S1-connection or NG-connection that Ella MOCN relays between a radio and an operator's MME or AMF. UE connections are learned at runtime, not stored.

## List UE Connections

This path returns the UE connections, oldest first.

| Method | Path |
| --- | --- |
| GET | `/api/v1/ue-connections` |

### Query Parameters

| Name | In | Type | Default | Allowed | Description |
| --- | --- | --- | --- | --- | --- |
| `page` | query | int | `1` | `>= 1` | 1-based page index. |
| `per_page` | query | int | `25` | `1…100` | Number of items per page. |
| `radio` | query | string |  |  | Only the UE connections of the radio with this [`ref`](<https://docs.ellanetworks.com/mocn/reference/api/radios/index.md#list-radios>). |
| `operator` | query | string |  |  | Only the UE connections of the [operator](<https://docs.ellanetworks.com/mocn/reference/api/operators/index.md>) with this name. |

### Response Fields

`items` holds the UE connections of the page, `page` and `per_page` echo the query, and `total_count` is the number of UE connections that match the filters. Each UE connection has:

| Field | Type | Description |
| --- | --- | --- |
| `interface` | string | `s1` or `ng`. |
| `radio` | object | The connection between the radio and Ella MOCN. |
| `radio.ref` | string | The radio's [`ref`](<https://docs.ellanetworks.com/mocn/reference/api/radios/index.md#list-radios>). |
| `radio.enb_ue_s1ap_id` | int | S1 only. eNB UE S1AP ID, allocated by the radio. `0` to `16777215`. Absent until the radio answers a HANDOVER REQUEST. |
| `radio.mme_ue_s1ap_id` | int | S1 only. MME UE S1AP ID, allocated by Ella MOCN. `0` to `4294967295`. |
| `radio.ran_ue_ngap_id` | int | NG only. RAN UE NGAP ID, allocated by the radio. `0` to `4294967295`. Absent until the radio answers a HANDOVER REQUEST. |
| `radio.amf_ue_ngap_id` | int | NG only. AMF UE NGAP ID, allocated by Ella MOCN. `0` to `1099511627775`. |
| `mme` | object | S1 only. The S1 connection between Ella MOCN and the operator's MME. |
| `mme.tnl_addresses` | array | The MME's TNL addresses, as configured on the operator. |
| `mme.enb_ue_s1ap_id` | int | eNB UE S1AP ID, allocated by Ella MOCN. `0` to `16777215`. |
| `mme.mme_ue_s1ap_id` | int | MME UE S1AP ID, allocated by the MME. Absent until the MME's first message for the UE. |
| `amf` | object | NG only. The NG connection between Ella MOCN and the operator's AMF. |
| `amf.tnl_addresses` | array | The AMF's TNL addresses, as configured on the operator. |
| `amf.ran_ue_ngap_id` | int | RAN UE NGAP ID, allocated by Ella MOCN. `0` to `4294967295`. |
| `amf.amf_ue_ngap_id` | int | AMF UE NGAP ID, allocated by the AMF. Absent until the AMF's first message for the UE. |
| `operator` | string | Name of the operator that serves the selected PLMN. |
| `plmn` | object | The selected PLMN, with `mcc` and `mnc`. |
| `since` | string | When Ella MOCN received the INITIAL UE MESSAGE, HANDOVER REQUEST or PATH SWITCH REQUEST. |
| `tai` | object | The last TAI the radio reported for the UE: `plmn` and `tac`, 6 lower-case hexadecimal digits. Absent when none. |
| `ecgi` | object | S1 only. The last E-UTRAN CGI the radio reported for the UE: `plmn` and `cell_id`, the 28-bit E-UTRAN Cell Identity. Absent when none. |
| `nr_cgi` | object | NG only. The last NR CGI the radio reported for the UE: `plmn` and `cell_id`, the 36-bit NR Cell Identity. Absent when none. |
| `tunnels` | array | With user-plane aggregation, the GTP-U tunnels Ella MOCN relays for the UE. Absent when none. |
| `tunnels[].bearer` | int | E-RAB ID or PDU session ID. |
| `tunnels[].direction` | string | `uplink` (from the radio) or `downlink` (from the operator). |
| `tunnels[].forwarding` | boolean | Handover data forwarding tunnel. |
| `tunnels[].address`, `tunnels[].teid` | string, int | Ella MOCN's endpoint the sender uses. |
| `tunnels[].peer_address`, `tunnels[].peer_teid` | string, int | The endpoint Ella MOCN forwards to. |
| `tunnels[].packets`, `tunnels[].bytes` | int | G-PDUs relayed so far, and the octets of their T-PDUs: the inner IP packet, without the GTP-U header and extension headers. End Marker and Tunnel Status messages are not counted. |

### Sample Response

```
{
    "result": {
        "items": [
            {
                "interface": "s1",
                "radio": {
                    "ref": "eNB:001-01:MacroeNB-0019c",
                    "enb_ue_s1ap_id": 1,
                    "mme_ue_s1ap_id": 1
                },
                "mme": {
                    "tnl_addresses": ["127.0.0.3"],
                    "enb_ue_s1ap_id": 1,
                    "mme_ue_s1ap_id": 101
                },
                "operator": "Operator B",
                "plmn": {"mcc": "001", "mnc": "02"},
                "since": "2026-11-13T16:31:56.646031138Z",
                "tai": {
                    "plmn": {"mcc": "001", "mnc": "02"},
                    "tac": "000001"
                },
                "ecgi": {
                    "plmn": {"mcc": "001", "mnc": "02"},
                    "cell_id": 105473
                }
            },
            {
                "interface": "ng",
                "radio": {
                    "ref": "gNB:001-01:000001@22",
                    "ran_ue_ngap_id": 0,
                    "amf_ue_ngap_id": 2
                },
                "amf": {
                    "tnl_addresses": ["127.0.0.2"],
                    "ran_ue_ngap_id": 2,
                    "amf_ue_ngap_id": 101
                },
                "operator": "Operator A",
                "plmn": {"mcc": "001", "mnc": "01"},
                "since": "2026-11-13T16:31:56.646102232Z",
                "tai": {
                    "plmn": {"mcc": "001", "mnc": "01"},
                    "tac": "000001"
                },
                "nr_cgi": {
                    "plmn": {"mcc": "001", "mnc": "01"},
                    "cell_id": 16384
                }
            }
        ],
        "page": 1,
        "per_page": 25,
        "total_count": 2
    }
}
```
