diff --git a/doc/README.md b/doc/README.md
index 03ef5940ce0fe93ed3cfc12f37be99ed757b23b9..b400aec49a81c177f3eefc8b4f70c635db29e207 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -73,6 +73,21 @@ hive.api.setOptions({ url: 'https://api.hive.blog' });
 
 # API
 
+## API CALL
+Can be used for all the possible API calls.
+
+```js
+hive.api.call(method, params, callback);
+// or
+hive.api.callAsync(method, params).then(res => {});
+```
+
+Example:
+```js
+hive.api.callAsync('condenser_api.get_accounts', [['mahdiyari']])
+  .then((res) => console.log(res))
+````
+
 ## Subscriptions
 
 ### Set Subscribe Callback
@@ -575,6 +590,7 @@ Return Example:
 ```
 
 ### Get State With Options
+**Warning:** getState calls are getting deprecated.
 
 ```js
 hive.api.getStateWith(options, callback);