Skip to content

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.
operator query string Only the UE connections of the operator 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.
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
    }
}