Skip to content

Get network events

Request

This endpoint retrieves network attach and data session events for a specific subscription identified by its ICCID over a specified time period.

Important constraints:

  • The maximum period is 7 days, including both the start and end dates
  • The start date must come before the end date
  • Requests that violate these constraints will be rejected

The response includes:

  • 2g_or_3g_attach: network attach events for 2G/3G connections
  • 4g_or_5g_attach: network attach events for 4G/5G connections
  • data_usage: data session events (Init/Update/Term)

Debugging eSIM installation/connectivity issues

If a user is unable to use their eSIM, use this endpoint to narrow down where the failure occurred:

  1. Failure to attach to network - First check the events under 2g_or_3g_attach or 4g_or_5g_attach, depending on which network the eSIM is connecting to, to see whether it was able to attach:
    • In 2g_or_3g_attach, if result is "ok", the attach succeeded.
    • In 4g_or_5g_attach, if oper_allowed is true, the attach succeeded.
  2. Failure to use data - If the eSIM successfully attached to the network, check the events under data_usage. If result is "success", the eSIM was able to use data; otherwise the data session failed.
Security
ApiKeyAuth
Path
iccidstringrequired

The ICCID of the subscription

Example:8948010000094659307
Bodyapplication/jsonrequired
periodobjectrequired

The time period for which to retrieve network events. Maximum period is 7 days including start and end dates.

POST
/v3/subscriptions/{iccid}/network-events
curl -i -X POST \
  'https://api.tellisim.com/v3/subscriptions/8948010000094659307/network-events?key=YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "period": {
      "start": "2026-08-15",
      "end": "2026-08-21"
    }
  }'

Responses

Successful response containing network events for the specified period

Bodyapplication/json
errorbooleanrequired

Indicates whether there was an error processing the request

Example:false
labelstring(Label)
Enum:"Green""Aqua""Blue""Voilet""Red""Grey""Orange"
dataobjectrequired

Contains the network events recorded for the subscription during the specified period

Response
{
  "error": false,
  "label": "Green",
  "data": {
    "2g_or_3g_attach": [ … ],
    "4g_or_5g_attach": [ … ],
    "data_usage": [ … ]
  }
}