diff --git a/doc/70-REST-API.md b/doc/70-REST-API.md
index 9a7ad7c8..1b45fe15 100644
--- a/doc/70-REST-API.md
+++ b/doc/70-REST-API.md
@@ -39,12 +39,15 @@ URL scheme and supported methods
 
 We support GET, POST, PUT and DELETE.
 
-| Method | Meaning
-| ------ | ------------------------------------------------------------
-| GET    | Read / fetch data. Not allowed to run operations with the potential to cause any harm
-| POST   | Trigger actions, create or modify objects. Can also be used to partially modify objects
-| PUT    | Creates or replaces objects, cannot be used to modify single object properties
-| DELETE | Remove a specific object
+| Method | Meaning                                                             |
+|--------|---------------------------------------------------------------------|
+| GET    | Read / fetch data. Not allowed to run operations with the potential |
+|        | to cause any harm                                                   |
+| POST   | Trigger actions, create or modify objects. Can also be used to      |
+|        | partially modify objects                                            |
+| PUT    | Creates or replaces objects, cannot be used to modify single object |
+|        | properties                                                          |
+| DELETE | Remove a specific object                                            |
 
 TODO: more examples showing the difference between POST and PUT
 
@@ -113,6 +116,14 @@ Icinga Objects
 
 ### Special parameters
 
+| Parameter    | Description                                                 |
+|--------------|-------------------------------------------------------------|
+| resolved     | Resolve all inherited properties and show a flat object     |
+| withNull     | Retrieve default (null) properties also                     |
+| withServices | Show services attached to a host. `resolved` and `withNull` |
+|              | are applied for services too                                |
+
+
 #### Resolve object properties
 
 In case you add the `resolved` parameter to your URL, all inherited object
@@ -121,15 +132,20 @@ properties will be resolved. Such a URL could look as follows:
     director/host?name=hostname.example.com&resolved
 
 
-#### Retrieve all properties
-
-TODO: adjust the code to fix this, current implementation has `withNull`
+#### Retrieve default (null) properties also
 
 Per default properties with `null` value are skipped when shipping a result.
-You can influence this behavior with the properties parameter. Just append
-`properties=ALL` to your URL:
+You can influence this behavior with the `properties` parameter. Just append
+`&withNull` to your URL:
 
-    director/host?name=hostname.example.com&properties=all
+    director/host?name=hostname.example.com&withNull
+
+
+#### Fetch host with it's services
+
+This is what the `withServices` parameter exists:
+
+    director/host?name=hostname.example.com&withServices
 
 
 #### Retrieve only specific properties
diff --git a/library/Director/RestApi/RestApiParams.php b/library/Director/RestApi/RestApiParams.php
index 4eadbcf2..c237ac51 100644
--- a/library/Director/RestApi/RestApiParams.php
+++ b/library/Director/RestApi/RestApiParams.php
@@ -13,8 +13,7 @@ class RestApiParams
         $params = $request->getUrl()->getParams();
         $resolved = (bool) $params->get('resolved', false);
         $withNull = $params->shift('withNull');
-        $withServices = (bool) $params->get('withServices');
-        if ($withServices) {
+        if ($params->get('withServices')) {
             if ($shortObjectType !== 'host') {
                 throw new InvalidArgumentException('withServices is available for Hosts only');
             }