search

Network Logs

hashtag
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 Logsarrow-up-right.

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
chevron-right
200

OK

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

OK

PreviousTagsNextSMS

Last updated