Accept a verified KORE byte-interval usage event for a SIM

Records one KORE Super SIM connection event (schema https://events-schemas.korewireless.com/SuperSim.ConnectionEvent/2, types com.twilio.iot.supersim.connection.data-session.updated and ...data-session.ended) as a byte interval in the SIM company's cellular usage history. data_total, data_upload and data_download are the bytes between data_session_update_start_time and data_session_update_end_time; session cumulative counters are not used. This is an authenticated platform API for a trusted connector, not a KORE webhook receiver: the caller needs Update permission on SIMs of its own company (also for a superuser), and the event's sim_iccid must equal the SIM's ICCID.

Idempotent per (source, id): the first delivery returns 201, an identical redelivery returns 200 (status: replay), and a different payload under the same id returns 409. Equivalent instants in other UTC offsets and JSON field order are identical deliveries. Acceptance does not make usage totals exact: the response always reports coverage: unknown and exact today and calendar month totals as unsupported.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The SIM's platform id.

Body Params

One KORE event, at most 65536 bytes.

string
required
length ≤ 256

Event id; equals data.event_sid.

string
enum
required
Allowed:
string
enum
required
Allowed:
string
enum
required
Allowed:
data
object
required
Responses

401

You are not authorized

403

The SIM belongs to another company, or the caller lacks SIM Update permission.

404

SIM not found.

409

A different payload was already accepted under this event's (source, id).

413

The body exceeds 65536 bytes.

422

Not a supported KORE v2 byte-interval event: wrong source, schema or type; mismatched id or type copies; ICCID not the SIM's; missing or inverted interval bounds; missing, negative or inconsistent metrics; a timestamp out of range; or an interval above 2147483647 bytes.

500

An unexpected error was encountered.

503

Usage ingestion is not provisioned for the SIM's company: it has no cellular usage history, or the history has not been provisioned by migration 202611121000 (or its provisioning function) yet.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json