homotechsual · 16bc31f8 · 16bc31f8 · 16bc31f8 · 16bc31f8 · 16bc31f8
--- a/docs/api/v3/usage.md
+++ b/docs/api/v3/usage.md
+Using the CRM.api3 method you can pass multiple requests through at once e.g.
+
+```javascript
+var params = [
+ ['email', 'get', {contact_id: 123}],
+ ['phone', 'get', {phone: '555-5555'}]
+];
+CRM.api3(params).done(function(result) {
+ console.log('email result is:', result[0]);
+ console.log('phone result is:', result[1]);
+});
+```
+
+You can also use associative objects in your API call as follows:
+
+```
--- a/docs/api/v4/usage.md
+++ b/docs/api/v4/usage.md
+ ]);
+}
+catch (\API_Exception $e) {
+ $error = $e->getMessage();
+}
+printf("Found %d item(s)\n", count($contacts));
+```
+
+This format matches canonical format almost exactly, with a few improvements for usability:
+
+  The `version => 4` parameter is not required.
+  Errors are reported as PHP exceptions. You may catch the exceptions or (by default) allow them to bubble up.
+ You can immediately iterate over the contacts returned
+
+*Note*: If you're writing a Drupal module, a Joomla extension, a WordPress plugin, or a standalone script, then you may need to **bootstrap** CiviCRM before using the API.  See the examples in [Bootstrap Reference].
+