Table of Contents


Available since version: 1.8
This function allows you to retrieve item details based on filtering options. All parameters are optional. If parameter is set in query this option counted as ON, except if parameter is equal to NULL.


nodeidsarrayNode IDs
groupidsarrayHostGroup IDs
hostidsarrayHost IDs
templateidsarrayTemplate IDs
proxyidsarrayReturn only items that belong to the hosts, that are monitored by the given proxies.
itemidsarrayItem IDs
graphidsarrayGraph IDs
triggeridsarrayTrigger IDs
applicationidsarrayApplication IDs
webitemsintegerSearch also in web items
inheritedintegerInherited from templates “0” - not inherited, “1” - inherited
templatedintegerTemplated items “0” - belongs to hosts, “1” - belongs to templates
monitoredintegerMonitored items Checks item and host status
editableintegeronly with read-write permission. Ignored for SuperAdmins
groupstringOptional filter by host group name
hoststringOptional filter by host name
applicationstringOptional filter by application name
belongsstringOptional filter by host fields
with_triggersintegerItems with triggers
filterarrayOptional filter by item fields
searchstringReturn items by given item fields pattern
startSearchintegerSearch given patterns only in start of the field
excludeSearchintegerExclude from result items by given patterns
searchWildcardsEnabledintegerSearch pattern in whole field using wildcards 1 - enable, 0 - disable
outputstringOutput options Values: shorten, refer, extend
select_hostsstringSelect hosts Values: shorten, refer, extend
select_triggersstringSelect item triggers Values: shorten, refer, extend
select_graphsstringSelect item graphs Values: shorten, refer, extend
select_applicationsstringSelect item applications Values: shorten, refer, extend
countOutputintegerCount hosts, return the number of items found
groupCountintegerReturn the number of results grouped by given IDs
preservekeysintegerReturn hash instead of array Keys of hash are object IDs
sortfieldstringSort by item field Values: itemid, description, key_, delay, history, trends, type, status
sortorderstringSort order Values: ASC, DESC
limitintmax number of item objects to return


resultOperation successful. Result will contain array of Item objects.
errorIn case of any errors


Get items details by item description pattern “Apache” and limit output to 10 items, return only item IDS:

	"search": {"description": "apache"},
	"limit": 10

Retrieved items details: