From 3228586a623575a619c20917e9e7472a41c98429 Mon Sep 17 00:00:00 2001
From: Michael Friedrich <michael.friedrich@netways.de>
Date: Wed, 24 Feb 2016 21:31:10 +0100
Subject: [PATCH] Docs: Add an example for API joins with comments and
 host/services

fixes #10976
---
 doc/9-icinga2-api.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/9-icinga2-api.md b/doc/9-icinga2-api.md
index ee0e6f45a..42c9d3077 100644
--- a/doc/9-icinga2-api.md
+++ b/doc/9-icinga2-api.md
@@ -501,6 +501,11 @@ via a join:
         ]
     }
 
+In case you want to fetch all [comments](6-object-types.md#objecttype-comment)
+for hosts and services, you can use the following query URL (similar example
+for downtimes):
+
+   https://localhost:5665/v1/objects/comments?joins=host&joins=service
 
 ### <a id="icinga2-api-config-objects-create"></a> Creating Config Objects