Help Center
Choose product document...
Veeam Backup & Replication 9.5 Update 4
RESTful API Reference

Lookup Service

In addition to the query service, Veeam Backup Enterprise Manager exposes the lookup service via its RESTful API. The lookup service lets the client facilitate search for objects in the virtual infrastructure hierarchy: hosts, VMs, clusters, resource pools, folders and so on.

The lookup service is specifically targeted at retrieving resource representations of virtual infrastructure objects and references to virtual infrastructure objects. Object references are required for some requests that refer to a specific node in the virtual infrastructure hierarchy. For example, if you want to add some VM to the backup job, you need to provide a reference to this VM when sending a request for job editing. Similarly, if you want to assign a restore scope to an account having a specific role in Veeam Backup Enterprise Manager, you need to provide a reference to the VM or VM container to which this account should have access.

The resource representation of the lookup service looks in the following way:

<LookupSvc xmlns="" Type="LookupService" Href="http://localhost:9399/api/lookupSvc">
   <Link Rel="Up" Type="LogonSession" Href="http://localhost:9399/api/logonSessions/764a855e-56a3-4cb1-a80a-cb5693b6527e" />
   <Link Rel="Down" Type="HierarchyItemList" Href="http://localhost:9399/api/lookup?host=urn%3aveeam%3aHierarchyRoot%3a3e7fea0c-e92d-4459-9842-0304df34c644&name=*&type=Vm" />
   <Link Rel="Down" Type="HierarchyItemList" Href="http://localhost:9399/api/lookup?host=urn%3aveeam%3aHierarchyRoot%3a195c7259-8d89-4f6e-9098-25ee1f432669&name=*&type=Vm" />
   <Link Rel="Down" Type="HierarchyItemList" Href="http://localhost:9399/api/lookup?host=urn%3aveeam%3aHierarchyRoot%3ae1366ef8-1b33-45d1-a026-ceb38cf73d39&name=*&type=Vm" />
   <Link Rel="Down" Type="HierarchyItemList" Href="http://localhost:9399/api/lookup?host=urn%3aveeam%3aHierarchyRoot%3ae1366ef8-1b33-45d1-a026-ceb38cf73d39&name=*&type=Tag" />
   <Link Rel="Down" Type="HierarchyItemList" Href="http://localhost:9399/api/lookup?host=urn%3aveeam%3aHierarchyRoot%3ae1366ef8-1b33-45d1-a026-ceb38cf73d39&name=*&type=StoragePod" />

The lookup service resource representation contains a set of links to hierarchy roots — VMware and Hyper-V hosts added to Veeam backup servers that are managed by Veeam Backup Enterprise Manager. By following a link from the resource representation, the client can get a list of VMs that reside on a specific VMware or Hyper-V host. For VMware hosts, the client can also get a list of inventory object tags and storage pods (datastore clusters).

The resource representation of the lookup service provides links to hosts, VMs, tags and storage pods only and may be used for browsing. To obtain a reference to a specific virtual hierarchy object of other type, the client must construct a query string to the lookup service in a specific format.

Lookup Service Tip:

The reference to the virtual infrastructure object can also be constructed manually. To learn more, see Appendix A. Constructing HierarchyObjRefType.


Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Agent Management Guide

Veeam Explorers User Guide

Backup and Restore of SQL Server Databases

Veeam Plug-ins for Enterprise Applications

PowerShell Reference

Veeam Explorers PowerShell Reference

RESTful API Reference

Required Permissions Reference

Veeam Availability for Nutanix AHV Documentation

Veeam Backup for Microsoft Office 365 Documentation

Veeam ONE Documentation

Veeam Agent for Windows Documentation

Veeam Agent for Linux Documentation

Veeam Management Pack Documentation