Network Logs

Retrieve Network Logs of a SIM

get

Retrieves the Network Logs for a specific SIM. Network Logs capture the complete connection lifecycle and help diagnose connectivity issues.

The response contains various different Log Types (distinguished by the log_type field). Each type holds different information and showcases the type of event that has occurred:

  • network-authentication: Initial connection attempt when device scans for and attempts to connect to a specific network. Records whether the SIM is allowed to connect based on Network List/Whitelist and IMEI settings.

    • Authentication log_types also include SIM and network information. A successful authentication will have status/reason properties as null in the response.

  • network-registration: Occurs after authentication when Onomondo and the given network sync to provide cellular technology connections. Has two phases:

    • Device registration to specific technology (is_data_attach: false), means that the device will be able to send and receive SMSs

    • Data session creation enabling data transmission (is_data_attach: true), means that the device will be able to send and receieve IP traffic

  • network-deregistration: Logs disconnection between Onomondo and the used network. Normal brief occurrences are expected, but frequent deregistrations may indicate connectivity issues.

For more information read How to use Network Logs.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
sim_idstringRequiredExample: 000000001
Query parameters
timestampstring · date-timeRequired

ISO 8601 timestamp in UTC format that sets the cursor for where records should start

Example: 2022-08-19T00:00:00.000ZPattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?Z$
orderstring · enumOptional

Temporal sort order for the results

Default: DESCExample: DESCPossible values:
limitinteger · min: 1 · max: 1000Optional

Maximum number of records to return

Default: 1000Example: 20
offsetintegerOptional

Number of records to skip (for pagination)

Default: 0Example: 0
Responses
200

OK

application/json
Responseobject
get
/network-logs/{sim_id}
200

OK

PreviousTagsNextSMS

Last updated