Machine-readable documentation index: /llms.txt. Markdown is available for every documentation and API page by appending .md to the URL, or by sending Accept: text/markdown.
Skip to main content

Usage Data: Platform 1.0 → 2.0

A usage record represents a single data-consumption session or SMS activity for a SIM.

Summary of changes​

The upgrade from the 1NCE Platform 1.0 usage stream to Data Streamer 2.0 is minimal. Both use the same structure and identical data types. The only changes are:

  • One field is renamed (session_id → ipcan_session_id).
  • Two fields are new (quota_id, rat_type).
  • One field is retired (currency_id — the currency is fixed to EUR for 1NCE).

What stays the same​

The following fields are identical in name, type, and meaning:

GroupFields
Identifiersid, ingestion_timestamp
Session windowstart_timestamp, end_timestamp
Deviceendpoint_id, endpoint_imei, endpoint_ip_address, endpoint_name, endpoint_tags
SIMsim_id, imsi_id
Operatoroperator_id, operator_country_id, operator_mnc
Organizationorganisation_id
Tarifftariff_id, tariff_ratezone_id
Traffictraffic_type_id (5 = Data, 6 = SMS)
Volumesvolume_rx, volume_tx, volume_total
Costcost

Fields that are renamed​

1NCE Platform 1.0 fieldData Streamer 2.0 fieldWhat it contains
session_idipcan_session_idSession identifier (UUID) correlating usage with event records

The data content is identical — only the field name changes. "IP-CAN" (IP Connectivity Access Network) is the standard telecom term for this session concept.

Fields that are new​

New fieldWhat it contains
quota_idQuota plan identifier active at time of consumption
rat_typeRadio Access Technology ID (resolve via GET /rat_types)

RAT type values​

IDTechnology
13G
22G
3WLAN
4GAN
5HSPA+
64G
8NB-IoT
9LTE-M
105G

Fields that are retired​

Retired fieldWhat it containsNotes
currency_idCurrency identifierNot exposed in Data Streamer 2.0 — the currency is fixed to EUR for 1NCE

Practical impact​

  • Field rename: update any code or query referencing session_id to use ipcan_session_id. The format and content are identical.
  • New capabilities: rat_type enables filtering and reporting by network technology; quota_id links usage to specific quota allocations.
  • Currency: if you read currency_id, remove the dependency — all 1NCE costs are in EUR.
  • Resolve IDs to names via the Reference Data (v2 API) endpoints.