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:
| Group | Fields |
|---|
| Identifiers | id, ingestion_timestamp |
| Session window | start_timestamp, end_timestamp |
| Device | endpoint_id, endpoint_imei, endpoint_ip_address, endpoint_name, endpoint_tags |
| SIM | sim_id, imsi_id |
| Operator | operator_id, operator_country_id, operator_mnc |
| Organization | organisation_id |
| Tariff | tariff_id, tariff_ratezone_id |
| Traffic | traffic_type_id (5 = Data, 6 = SMS) |
| Volumes | volume_rx, volume_tx, volume_total |
| Cost | cost |
Fields that are renamed
| 1NCE Platform 1.0 field | Data Streamer 2.0 field | What it contains |
|---|
session_id | ipcan_session_id | Session 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 field | What it contains |
|---|
quota_id | Quota plan identifier active at time of consumption |
rat_type | Radio Access Technology ID (resolve via GET /rat_types) |
RAT type values
| ID | Technology |
|---|
| 1 | 3G |
| 2 | 2G |
| 3 | WLAN |
| 4 | GAN |
| 5 | HSPA+ |
| 6 | 4G |
| 8 | NB-IoT |
| 9 | LTE-M |
| 10 | 5G |
Fields that are retired
| Retired field | What it contains | Notes |
|---|
currency_id | Currency identifier | Not 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.