List events

GET

https://cdn.emnify.net/api/v1/event

GET

/api/v1/event

1 curl https://cdn.emnify.net/ \
2      -H "Authorization: Bearer <token>"

1 [
2   {
3     "id": 123456,
4     "alert": true,
5     "description": "Disconnecting data access for endpoint, because it has been disabled.",
6     "timestamp": "2020-07-20T14:19:29.000+0000",
7     "event_type": {
8       "id": 0,
9       "description": "Generic"
10     },
11     "event_source": {
12       "id": 1,
13       "description": "Policy Control"
14     },
15     "event_severity": {
16       "id": 1,
17       "description": "Warn"
18     },
19     "organisation": {
20       "id": 1234,
21       "name": "Example Organisation"
22     },
23     "endpoint": {
24       "id": 123456,
25       "name": "My Endpoint",
26       "ip_address": "10.10.10.10",
27       "imei": "1234567890123456"
28     },
29     "imsi": {
30       "id": 1234,
31       "imsi": "123456789123456",
32       "import_date": "2019-01-22T13:38:30.000+0000"
33     },
34     "sim": {
35       "id": 1234,
36       "iccid": "8988303000123456789",
37       "iccid_with_luhn": "89883030001234567891",
38       "production_date": "2019-01-22T13:38:30.000+0000"
39     }
40   }
41 ]

Returns the list of events, filtered, sorted and paged according to query parameters.

Authentication

AuthorizationBearer

An auth_token should be provided to authenticate a session.

To obtain an auth_token, see the /api/v1/authenticate POST request.

Query parameters

pageintegerOptional

Current page number

per_pageintegerOptional

Defines the number of items per page

sortstringOptional

Sort properties according to a comma separated list of accepted fields. Valid fields are:

id - (event id)
timestamp - (event timestamp)
source - (event source)
severity - (event severity)
alert - (alert status)
organisation - (organisation name)
user - (user id)
endpoint - (endpoint name)
tags - (endpoint tags)
ip_address - (endpoint ip_address)
iccid - (sim iccid)
imsi - (sim imsi)
type - (event type)

Sort properties according to a comma separated list of accepted fields. Valid fields are: * `id` - (**event id**) * `timestamp` - (**event timestamp**) * `source` - (**event source**) * `severity` - (**event severity**) * `alert` - (**alert status**) * `organisation` - (**organisation name**) * `user` - (**user id**) * `endpoint` - (**endpoint name**) * `tags` - (**endpoint tags**) * `ip_address` - (**endpoint ip_address**) * `iccid` - (**sim iccid**) * `imsi` - (**sim imsi**) * `type` - (**event type**)

qstringOptional

format: "(from|until|type|source|severity|alert|description|organisation|user|endpoint|tags|ip_address|imei|iccid|iccid_with_luhn|imsi|timestamp|network|rat|country):.+"

Filter parameter in <filter>:<value> format. Multiple filters must be a comma-separated list of the following fields:

from (date, format YYYY-MM-DDTHH:mm:ssZ, only valid with until)
until (date, format YYYY-MM-DDTHH:mm:ssZ, only valid with from)
type (event_type, numerical)
source (event_type, numerical, e.g. 0 = Network), 1 = Policy Control, 2 = API)
severity (event_severity, numerical, e.g. 0 = Info, 1 = Warn), 2 = Critical)
alert (boolean, e.g. true, false)
description (event description, string)
organisation (organisation name, string)
user (user name, string)
endpoint (endpoint name, string)
tags (endpoint tags, string)
ip_address (endpoint IP address, valid IPv4/IPv6 address)
imei (endpoint imei, numerical string)
iccid (sim iccid, numerical string)
imsi (sim imsi, numerical string)
timestamp (date, format YYYY-MM-DDTHH:mm:ssZ, for querying events of 1 day, deprecated in future)
iccid_with_luhn (sim iccid with Luhn, numerical string)
network (endpoint network, string, e.g. Telekom)
rat (event pdp context rat type, numerical string, e.g. 6)
country (endpoint country, string, e.g. Germany)

Some filters can accept up to 6 values which must be separated by the pipe symbol (|) or url-encoded as (%7C):

iccid (q: iccid:1234567890123456789|8988303000123456789)
iccid_with_luhn (q: iccid:12345678901234567891|89883030001234567891)
endpoint (q: endpoint:example_endpoint_name|another_endpoint_name)
type (q: type:example_event_type|another_event_type)
network (q: network:example_network|another_network)
rat (q: rat:example_rat|another_rat)
country (q: country:example_country|another_country)

Filter parameter in `<filter>:<value>` format. Multiple filters must be a comma-separated list of the following fields: * `from` (**date**, format `YYYY-MM-DDTHH:mm:ssZ`, **only valid with until**) * `until` (**date**, format `YYYY-MM-DDTHH:mm:ssZ`, **only valid with from**) * `type` (**event_type**, numerical) * `source` (**event_type**, numerical, e.g. 0 = Network), 1 = Policy Control, 2 = API) * `severity` (**event_severity**, numerical, e.g. 0 = Info, 1 = Warn), 2 = Critical) * `alert` (boolean, e.g. true, false) * `description` (**event description**, string) * `organisation` (**organisation name**, string) * `user` (**user name**, string) * `endpoint` (**endpoint name**, string) * `tags` (**endpoint tags**, string) * `ip_address` (**endpoint IP address**, valid IPv4/IPv6 address) * `imei` (**endpoint imei**, numerical string) * `iccid` (**sim iccid**, numerical string) * `imsi` (**sim imsi**, numerical string) * `timestamp` (**date**, format `YYYY-MM-DDTHH:mm:ssZ`, for querying events of 1 day, deprecated in future) * `iccid_with_luhn` (**sim iccid with Luhn**, numerical string) * `network` (**endpoint network**, string, e.g. Telekom) * `rat` (**event pdp context rat type**, numerical string, e.g. 6) * `country` (**endpoint country**, string, e.g. Germany) Some filters can accept up to 6 values which must be separated by the pipe symbol (`|`) or url-encoded as (`%7C`): * `iccid` (q: iccid:1234567890123456789|8988303000123456789) * `iccid_with_luhn` (q: iccid:12345678901234567891|89883030001234567891) * `endpoint` (q: endpoint:example_endpoint_name|another_endpoint_name) * `type` (q: type:example_event_type|another_event_type) * `network` (q: network:example_network|another_network) * `rat` (q: rat:example_rat|another_rat) * `country` (q: country:example_country|another_country)

Response headers

x-count-per-pageinteger

The requested per_page parameter

x-current-pageinteger

The current page number within the current data set

x-total-countinteger

The total element count in the current data set

x-total-pagesinteger

The total page count in the current data set

x-filterstring

If filtering is applied using ?q=field:criteria URL query parameters, the filter criteria is returned here

x-sortstring

If sorting is applied using ?sort=sort_criteria URL query parameters, the sort criteria is returned here

Response

Successfully returned a list of events

idinteger

alertboolean

descriptionstring

timestampstring

event_typeobject

event_sourceobject

event_severityobject

organisationobject

userobject

Errors

400

Bad Request Error

422

Unprocessable Entity Error