| value | integer/​array | Return only events with the given values. |

+

| time_from | timestamp | Return only events that have been created after or at the given time. |

+

| time_till | timestamp | Return only events that have been created before or at the given time. |

+

| eventid_from | string | Return only events with IDs greater or equal to the given ID. |

+

| eventid_till | string | Return only events with IDs less or equal to the given ID. |

+

^ |||

+

| selectHosts | query | Return hosts containing the trigger that created the event in the ''​hosts''​ property. \\ \\ Does not support ''​shorten''​ or arrays of properties. |

+

| selectItems | query | Return items contained in the trigger that created the event in the ''​items''​ property. \\ \\ Does not support ''​shorten''​ or arrays of properties. |

+

| selectTriggers | query | Return the trigger that created the event as an array in the ''​triggers''​ property. \\ \\ Does not support ''​shorten''​ or arrays of properties. |

+

| select_alerts | query | Return alerts generated by the event in the ''​alerts''​ property. Alerts are sorted in reverse chronological order. \\ \\ Does not support ''​shorten''​ or arrays of properties. |

| countOutput |flag|These parameters being common for all ''​get''​ methods are described in detail on the [[manual:​appendix:​api:​generic#​common_get_method_parameters|Generic Zabbix API information]] page. |

+

| editable |boolean|:::​|

+

| excludeSearch |flag|:::​|

+

| filter | object |:::|

+

| limit |integer|:::​|

+

| nodeids |string/​array|:::​|

+

| output |query|:::​|

+

| preservekeys |flag|:::​|

+

| search | object |:::|

+

| searchByAny |boolean|:::​|

+

| searchWildcardsEnabled |boolean|:::​|

+

| sortorder | string/​array | ::: |

+

| startSearch |flag|:::​|

+

==== Return values ====

+

+

''​(integer/​array)''​ Returns either:

+

* an array of objects;

+

* the count of retrieved objects, if the ''​countOutput''​ parameter has been used.

+

+

==== Examples ====

+

+

=== Retrieving trigger events ===

+

+

Retrieve the latest events from trigger "​13926."​

+

+

Request:

+

<​code ​java>

{

{

-

"​jsonrpc":"​2.0",​

+

​"​jsonrpc":​ "​2.0",​

-

"​method":"​event.get",​

+

"​method":​ "​event.get",​

-

"​params":​{

+

"​params":​ {

-

"time_from":"​1284910040",

+

"output": "extend",

-

"time_till": "1284991200",

+

"select_acknowledges": "extend",

-

"output": "extend",

+

"triggerids": "13926",

-

"​sortfield":​ "clock",

+

"​sortfield":​ "eventid",

-

"​sortorder":​ "desc",

+

"​sortorder":​ "DESC"

-

"​limit":​ 5

+

},

-

},

+

"​auth":​ "038e1d7b1735c6a5436ee9eae095879e",

-

"​auth":"​6f38cddc44cfbb6c1bd186f9a220b5a0",

+

"​id": ​1

-

"​id":​2

+

}

}

</​code>​

</​code>​

-

Retrieved events details:

+

Response:

+

<code java>

+

{

+

"​jsonrpc":​ "​2.0",​

+

"​result":​ [

+

{

+

"​acknowledges":​ [

+

{

+

"​acknowledgeid":​ "​1",​

+

"​userid":​ "​1",​

+

"​eventid":​ "​9695",​

+

"​clock":​ "​1350640590",​

+

"​message":​ "​Problem resolved.\n\r----[BULK ACKNOWLEDGE]----",​

+

"​alias":​ "​Admin"​

+

}

+

],

+

"​eventid":​ "​9695",​

+

"​source":​ "​0",​

+

"​object":​ "​0",​

+

"​objectid":​ "​13926",​

+

"​clock":​ "​1347970410",​

+

"​value":​ "​1",​

+

"​acknowledged":​ "​1",​

+

"​ns":​ "​413316245",​

+

"​value_changed":​ "​1"​

+

},

+

{

+

"​acknowledges":​ [],

+

"​eventid":​ "​9671",​

+

"​source":​ "​0",​

+

"​object":​ "​0",​

+

"​objectid":​ "​13926",​

+

"​clock":​ "​1347970347",​

+

"​value":​ "​2",​

+

"​acknowledged":​ "​0",​

+

"​ns":​ "​0",​

+

"​value_changed":​ "​0"​

+

}

+

],

+

"​id":​ 1

+

}

+

</​code>​

-

<​code ​js>

+

=== Retrieving events by time period ===

+

+

Retrieve all events that have been created between October 9 and 10, 2012, in reverse chronological order.