From 4fccf1574ec0d2507c07aec583c4211fedf93c08 Mon Sep 17 00:00:00 2001
From: Claudio Sanches <contato@claudiosmweb.com>
Date: Thu, 30 Jul 2015 17:21:29 -0300
Subject: [PATCH 01/18] Created initial v3 docs and created changelog for v3

---
 source/includes/v2/_introduction.md |   41 +-
 source/includes/v3/_coupons.md      |  598 ++++++++
 source/includes/v3/_customers.md    |  985 ++++++++++++
 source/includes/v3/_index.md        |  409 +++++
 source/includes/v3/_introduction.md |  507 ++++++
 source/includes/v3/_orders.md       | 2217 +++++++++++++++++++++++++++
 source/includes/v3/_products.md     | 2106 +++++++++++++++++++++++++
 source/includes/v3/_reports.md      |  259 ++++
 source/includes/v3/_webhooks.md     |  659 ++++++++
 source/index.md                     |   18 +-
 source/v2.md                        |   31 +
 11 files changed, 7814 insertions(+), 16 deletions(-)
 create mode 100644 source/includes/v3/_coupons.md
 create mode 100644 source/includes/v3/_customers.md
 create mode 100644 source/includes/v3/_index.md
 create mode 100644 source/includes/v3/_introduction.md
 create mode 100644 source/includes/v3/_orders.md
 create mode 100644 source/includes/v3/_products.md
 create mode 100644 source/includes/v3/_reports.md
 create mode 100644 source/includes/v3/_webhooks.md
 create mode 100644 source/v2.md

diff --git a/source/includes/v2/_introduction.md b/source/includes/v2/_introduction.md
index 702fd8c0..30973c17 100644
--- a/source/includes/v2/_introduction.md
+++ b/source/includes/v2/_introduction.md
@@ -10,17 +10,19 @@ You must be using WooCommerce 2.1 or newer and the REST API must be enabled unde
 Many endpoints were improving with new versions of WooCommerce, so we always recommend keeping your WooCommerce updated to work properly with this documentation.
 </aside>
 
-## Schema ##
-
-The API is accessible via this endpoint:
+## Version ##
 
-`https://www.your-store.com/wc-api/v2`
+The current API version is `v3` which takes a first-order position in endpoints.
 
-You may access the API over either HTTP or HTTPS. HTTPS is recommended where possible, as authentication is simpler. The API index will declare if the site supports SSL or not.
+Check the API versions present in every version of WooCommerce:
 
-## Version ##
+| API Version |          WooCommerce          |
+| ----------- | ----------------------------- |
+| `v1`        | 2.1.x, 2.2.x, 2.3.x and 2.4.x |
+| `v2`        | 2.2.x, 2.3.x and 2.4.x        |
+| `v3`        | 2.4.x                         |
 
-The current API version is `v2` which takes a first-order position in endpoints. The `v1` endpoint is available in WooCommerce 2.1 / 2.2 / 2.3, but it will be removed in a future version.
+The `v1` and `v2` will be removed in future versions.
 
 ### Differences between v1 and v2 versions ###
 
@@ -33,6 +35,31 @@ The current API version is `v2` which takes a first-order position in endpoints.
 * v1 does not include any endpoints for getting valid order statuses, v2 includes an endpoint for listing valid order statuses (`GET /orders/statuses`).
 * v2 supports the core features added in WooCommerce 2.2, primarily order refunds (via the `/orders/refunds` endpoint) and Webhooks (via the `/webhooks`).
 
+### Differences between v3 and old versions ###
+
+* v3 implement full basic authentication ([conforms to the Basic auth spec)](http://www.w3.org/Protocols/HTTP/1.0/spec.html)).
+* v3 fixes the OAuth implementation to be compliant with the [Oauth 1.0a specs](http://tools.ietf.org/html/rfc5849).
+* v3 include a new endpoint to get all product orders.
+* v3 have new endpoints to allow bulk actions as edition and creation of products, orders, customers and coupons.
+* v3 introduce new product attribute endpoints (`GET`, `POST`, `PUT` and `DELETE`).
+* v3 deprecated the product/sku/&lt;id&gt; endpoint (because a SKU can be generated with any character, besides that there is a filter callend `filter[sku]`).
+* v3 include category thumbnails on the requests for `product/categories`.
+* v3 uses our option to auto generate passwords for new customers.
+
+### API Docs for each version ###
+
+* [WooCommerce REST API v1 docs](v1.html)
+* [WooCommerce REST API v2 docs](v2.html)
+* [WooCommerce REST API v3 docs](index.html)
+
+## Schema ##
+
+The API is accessible via this endpoint:
+
+`https://www.your-store.com/wc-api/v2`
+
+You may access the API over either HTTP or HTTPS. HTTPS is recommended where possible, as authentication is simpler. The API index will declare if the site supports SSL or not.
+
 ## Requests/Responses ##
 
 The default response format is JSON. Requests with a message-body use plain JSON to set or update resource attributes. Successful requests will return a `200 OK` HTTP status.
diff --git a/source/includes/v3/_coupons.md b/source/includes/v3/_coupons.md
new file mode 100644
index 00000000..c86e88f7
--- /dev/null
+++ b/source/includes/v3/_coupons.md
@@ -0,0 +1,598 @@
+# Coupons #
+
+This section lists all API that can be used to create, edit or otherwise manipulate coupons.
+
+## Coupon Properties ##
+
+|           Attribute            |   Type  |                                                        Description                                                         |
+| ------------------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------- |
+| `id`                           | integer | Coupon ID (post ID) <i class="label label-info">read-only</i>                                                              |
+| `code`                         | string  | Coupon code, always lowercase <i class="label label-info">mandatory</i>                                                    |
+| `type`                         | string  | Coupon type, valid core types are: `fixed_cart`, `percent`, `fixed_product` and `percent_product`. Default is `fixed_cart` |
+| `created_at`                   | string  | UTC DateTime when the coupon was created <i class="label label-info">read-only</i>                                         |
+| `updated_at`                   | string  | UTC DateTime when the coupon was last updated <i class="label label-info">read-only</i>                                    |
+| `amount`                       | float   | The amount of discount                                                                                                     |
+| `individual_use`               | boolean | Whether coupon can only be used individually                                                                               |
+| `product_ids`                  | array   | Array of product ID's the coupon can be used on                                                                            |
+| `exclude_product_ids`          | array   | Array of product ID's the coupon cannot be used on                                                                         |
+| `usage_limit`                  | integer | How many times the coupon can be used                                                                                      |
+| `usage_limit_per_user`         | integer | How many times the coupon can be user per customer                                                                         |
+| `limit_usage_to_x_items`       | integer | Max number of items in the cart the coupon can be applied to                                                               |
+| `usage_count`                  | integer | Number of times the coupon has been used already <i class="label label-info">read-only</i>                                 |
+| `expiry_date`                  | string  | UTC DateTime`when the coupon expires                                                                                       |
+| `enable_free_shipping`         | boolean | Is the coupon for free shipping                                                                                            |
+| `product_category_ids`         | array   | Array of category ID's the coupon applies to                                                                               |
+| `exclude_product_category_ids` | array   | Array of category ID's the coupon does not apply to                                                                        |
+| `exclude_sale_items`           | boolean | Exclude sale items from the coupon                                                                                         |
+| `minimum_amount`               | float   | Minimum order amount that needs to be in the cart before coupon applies                                                    |
+| `maximum_amount`               | float   | Maximum order amount allowed when using the coupon                                                                         |
+| `customer_emails`              | array   | Array of email addresses that can use this coupon                                                                          |
+| `description`                  | string  | Coupon description                                                                                                         |
+
+## Create A Coupon ##
+
+This API helps you to create a new coupon.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-post">POST</i>
+		<h6>/wc-api/v2/coupons</h6>
+	</div>
+</div>
+
+```shell
+curl -X POST https://example.com/wc-api/v2/coupons \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "coupon": {
+    "code": "new-coupon",
+    "type": "percent",
+    "amount": "10",
+    "individual_use": true,
+    "product_ids": [],
+    "exclude_product_ids": [],
+    "usage_limit": "",
+    "usage_limit_per_user": "",
+    "limit_usage_to_x_items": "",
+    "expiry_date": "",
+    "enable_free_shipping": false,
+    "product_category_ids": [],
+    "exclude_product_category_ids": [],
+    "exclude_sale_items": true,
+    "minimum_amount": "100.00",
+    "maximum_amount": "0.00",
+    "customer_emails": [],
+    "description": ""
+  }
+}'
+```
+
+```javascript
+var data = {
+  coupon: {
+    code: 'new-coupon',
+    type: 'percent',
+    amount: '10',
+    individual_use: true,
+    product_ids: [],
+    exclude_product_ids: [],
+    usage_limit: '',
+    usage_limit_per_user: '',
+    limit_usage_to_x_items: '',
+    expiry_date: '',
+    enable_free_shipping: false,
+    product_category_ids: [],
+    exclude_product_category_ids: [],
+    exclude_sale_items: true,
+    minimum_amount: '100.00',
+    maximum_amount: '0.00',
+    customer_emails: [],
+    description: ''
+  }
+};
+
+WooCommerce.post('coupons', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "coupon": {
+        "code": "new-coupon3",
+        "type": "percent",
+        "amount": "10",
+        "individual_use": True,
+        "product_ids": [],
+        "exclude_product_ids": [],
+        "usage_limit": "",
+        "usage_limit_per_user": "",
+        "limit_usage_to_x_items": "",
+        "expiry_date": "",
+        "enable_free_shipping": False,
+        "product_category_ids": [],
+        "exclude_product_category_ids": [],
+        "exclude_sale_items": True,
+        "minimum_amount": "100.00",
+        "maximum_amount": "0.00",
+        "customer_emails": [],
+        "description": ""
+    }
+}
+
+print(wcapi.post("coupons", data).json())
+```
+
+```php
+<?php
+$data = array(
+    'coupon' => array(
+        'code' => 'new-coupon3',
+        'type' => 'percent',
+        'amount' => '10',
+        'individual_use' => true,
+        'product_ids' => array(),
+        'exclude_product_ids' => array(),
+        'usage_limit' => '',
+        'usage_limit_per_user' => '',
+        'limit_usage_to_x_items' => '',
+        'expiry_date' => '',
+        'enable_free_shipping' => false,
+        'product_category_ids' => array(),
+        'exclude_product_category_ids' => array(),
+        'exclude_sale_items' => true,
+        'minimum_amount' => '100.00',
+        'maximum_amount' => '0.00',
+        'customer_emails' => array(),
+        'description' => ''
+    )
+);
+
+print_r($woocommerce->coupons->create($data));
+?>
+```
+
+```ruby
+data = {
+  coupon: {
+    code: "new-coupon",
+    type: "percent",
+    amount: "10",
+    individual_use: true,
+    product_ids: [],
+    exclude_product_ids: [],
+    usage_limit: "",
+    usage_limit_per_user: "",
+    limit_usage_to_x_items: "",
+    expiry_date: "",
+    enable_free_shipping: false,
+    product_category_ids: [],
+    exclude_product_category_ids: [],
+    exclude_sale_items: true,
+    minimum_amount: "100.00",
+    maximum_amount: "0.00",
+    customer_emails: [],
+    description: ""
+  }
+}
+
+woocommerce.post("coupons", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "coupon": {
+    "id": 529,
+    "code": "new-coupon",
+    "type": "percent",
+    "created_at": "2015-01-20T19:05:27Z",
+    "updated_at": "2015-01-20T19:05:27Z",
+    "amount": "10.00",
+    "individual_use": true,
+    "product_ids": [],
+    "exclude_product_ids": [],
+    "usage_limit": null,
+    "usage_limit_per_user": null,
+    "limit_usage_to_x_items": 0,
+    "usage_count": 0,
+    "expiry_date": null,
+    "enable_free_shipping": false,
+    "product_category_ids": [],
+    "exclude_product_category_ids": [],
+    "exclude_sale_items": true,
+    "minimum_amount": "100.00",
+    "maximum_amount": "0.00",
+    "customer_emails": [],
+    "description": ""
+  }
+}
+```
+
+## View A Coupon ##
+
+This API lets you retrieve and view a specific coupon by ID or code.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/coupons/&lt;id&gt;</h6>
+	</div>
+</div>
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/coupons/code/&lt;code&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/coupons/529 \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('coupons/529', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("coupons/529").json())
+```
+
+```php
+<?php print_r($woocommerce->coupons->get(529)); ?>
+```
+
+```ruby
+woocommerce.get("coupons/529").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "coupon": {
+    "id": 529,
+    "code": "new-coupon",
+    "type": "percent",
+    "created_at": "2015-01-20T19:05:27Z",
+    "updated_at": "2015-01-20T19:05:27Z",
+    "amount": "10.00",
+    "individual_use": true,
+    "product_ids": [],
+    "exclude_product_ids": [],
+    "usage_limit": null,
+    "usage_limit_per_user": null,
+    "limit_usage_to_x_items": 0,
+    "usage_count": 0,
+    "expiry_date": null,
+    "enable_free_shipping": false,
+    "product_category_ids": [],
+    "exclude_product_category_ids": [],
+    "exclude_sale_items": true,
+    "minimum_amount": "100.00",
+    "maximum_amount": "0.00",
+    "customer_emails": [],
+    "description": ""
+  }
+}
+```
+
+## View List Of Coupons ##
+
+This API helps you to view all the coupons.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/coupons</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/coupons \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('coupons', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("coupons").json())
+```
+
+```php
+<?php print_r($woocommerce->coupons->get()); ?>
+```
+
+```ruby
+woocommerce.get("coupons").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "coupons": [
+    {
+      "id": 529,
+      "code": "new-coupon",
+      "type": "percent",
+      "created_at": "2015-01-20T19:05:27Z",
+      "updated_at": "2015-01-20T19:05:27Z",
+      "amount": "10.00",
+      "individual_use": true,
+      "product_ids": [],
+      "exclude_product_ids": [],
+      "usage_limit": null,
+      "usage_limit_per_user": null,
+      "limit_usage_to_x_items": 0,
+      "usage_count": 0,
+      "expiry_date": null,
+      "enable_free_shipping": false,
+      "product_category_ids": [],
+      "exclude_product_category_ids": [],
+      "exclude_sale_items": true,
+      "minimum_amount": "100.00",
+      "maximum_amount": "0.00",
+      "customer_emails": [],
+      "description": ""
+    },
+    {
+      "id": 527,
+      "code": "free-shipping",
+      "type": "fixed_cart",
+      "created_at": "2015-01-20T18:35:59Z",
+      "updated_at": "2015-01-20T18:35:59Z",
+      "amount": "0.00",
+      "individual_use": true,
+      "product_ids": [],
+      "exclude_product_ids": [],
+      "usage_limit": null,
+      "usage_limit_per_user": null,
+      "limit_usage_to_x_items": 0,
+      "usage_count": 0,
+      "expiry_date": null,
+      "enable_free_shipping": true,
+      "product_category_ids": [],
+      "exclude_product_category_ids": [],
+      "exclude_sale_items": true,
+      "minimum_amount": "50.00",
+      "maximum_amount": "0.00",
+      "customer_emails": [],
+      "description": ""
+    },
+    {
+      "id": 526,
+      "code": "christmas-promo",
+      "type": "percent",
+      "created_at": "2015-01-20T18:10:58Z",
+      "updated_at": "2015-01-20T18:10:58Z",
+      "amount": "10.00",
+      "individual_use": true,
+      "product_ids": [],
+      "exclude_product_ids": [],
+      "usage_limit": null,
+      "usage_limit_per_user": 1,
+      "limit_usage_to_x_items": 0,
+      "usage_count": 0,
+      "expiry_date": "2014-12-25T00:00:00Z",
+      "enable_free_shipping": false,
+      "product_category_ids": [],
+      "exclude_product_category_ids": [],
+      "exclude_sale_items": true,
+      "minimum_amount": "200.00",
+      "maximum_amount": "0.00",
+      "customer_emails": [],
+      "description": "Discount for Christmas for orders over $ 200"
+    }
+  ]
+}
+```
+
+## Update A Coupon ##
+
+This API lets you make changes to a coupon.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-put">PUT</i>
+		<h6>/wc-api/v2/coupons/&lt;id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl -X PUT https://example.com/wc-api/v2/coupons/529 \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "coupon": {
+    "amount": "5"
+  }
+}'
+```
+
+```javascript
+var data = {
+  coupon: {
+    amount: '5'
+  }
+};
+
+WooCommerce.put('coupons/529', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "coupon": {
+        "amount": "5"
+    }
+}
+
+print(wcapi.put("coupons/529", data).json())
+```
+
+```php
+<?php
+$data = array(
+	'coupon' => array(
+		'amount' => '5'
+	)
+);
+
+print_r($woocommerce->coupons->update(529, $data));
+?>
+```
+
+```ruby
+data {
+  coupon: {
+    amount: "5"
+  }
+}
+
+woocommerce.put("coupons/529", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "coupon": {
+    "id": 529,
+    "code": "new-coupon",
+    "type": "percent",
+    "created_at": "2015-01-20T19:05:27Z",
+    "updated_at": "2015-01-20T19:10:33Z",
+    "amount": "5.00",
+    "individual_use": true,
+    "product_ids": [],
+    "exclude_product_ids": [],
+    "usage_limit": null,
+    "usage_limit_per_user": null,
+    "limit_usage_to_x_items": 0,
+    "usage_count": 0,
+    "expiry_date": null,
+    "enable_free_shipping": false,
+    "product_category_ids": [],
+    "exclude_product_category_ids": [],
+    "exclude_sale_items": true,
+    "minimum_amount": "100.00",
+    "maximum_amount": "0.00",
+    "customer_emails": [],
+    "description": ""
+  }
+}
+```
+
+## Delete A Coupon ##
+
+This API helps you delete a coupon.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-delete">DELETE</i>
+		<h6>/wc-api/v2/coupons/&lt;id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl -X DELETE https://example.com/wc-api/v2/coupons/529/?force=true \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.delete('coupons/529/?force=true', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.delete("coupons/529?force=true").json())
+```
+
+```php
+<?php print_r($woocommerce->coupons->delete(529, true)); ?>
+```
+
+```ruby
+woocommerce.delete("coupons/529?force=true").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "message": "Permanently deleted coupon"
+}
+```
+
+### Parameters ###
+
+| Parameter |  Type  |                                                                          Description                                                                           |
+| --------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `force`   | string | Use `true` whether to permanently delete the coupon, defaults to `false`. Note that permanently deleting the coupon will return HTTP 200 rather than HTTP 202. |
+
+## View Coupons Count ##
+
+This API lets you retrieve a count of all coupons.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/coupons/count</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/coupons/count \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('coupons/count', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("coupons/count").json())
+```
+
+```php
+<?php print_r($woocommerce->coupons->get_count()); ?>
+```
+
+```ruby
+woocommerce.get("coupons/count").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "count": 3
+}
+```
diff --git a/source/includes/v3/_customers.md b/source/includes/v3/_customers.md
new file mode 100644
index 00000000..797a110d
--- /dev/null
+++ b/source/includes/v3/_customers.md
@@ -0,0 +1,985 @@
+# Customers #
+
+This section lists all API that can be used to create, edit or otherwise manipulate customers.
+
+## Customers Properties ##
+
+|     Attribute      |   Type  |                                                                                                    Description                                                                                                     |
+| ------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `id`               | integer | Customer ID (user ID) <i class="label label-info">read-only</i>                                                                                                                                                    |
+| `created_at`       | string  | UTC DateTime when the customer was created <i class="label label-info">read-only</i>                                                                                                                               |
+| `email`            | string  | Customer email address <i class="label label-info">mandatory</i>                                                                                                                                                   |
+| `first_name`       | string  | Customer first name                                                                                                                                                                                                |
+| `last_name`        | string  | Customer last name                                                                                                                                                                                                 |
+| `username`         | string  | Customer username, can be generated automatically from the customer's email addrees if the option `woocommerce_registration_generate_username` is equal to `yes` <i class="label label-info">cannot be changed</i> |
+| `password`         | string  | Customer password, can be generated automatically with [`wp_generate_password()`](http://codex.wordpress.org/Function_Reference/wp_generate_password) <i class="label label-info">write-only</i>                   |
+| `last_order_id`    | integer | Last order ID <i class="label label-info">read-only</i>                                                                                                                                                            |
+| `last_order_date`  | string  | UTC DateTime of the customer last order <i class="label label-info">read-only</i>                                                                                                                                  |
+| `orders_count`     | integer | Quantity of orders that the customer have <i class="label label-info">read-only</i>                                                                                                                                |
+| `total_spent`      | integer | Total amount spent <i class="label label-info">read-only</i>                                                                                                                                                       |
+| `avatar_url`       | string  | Gravatar URL                                                                                                                                                                                                       |
+| `billing_address`  | array   | List of Billing Address fields. See [Billing Address Properties](#billing-address-properties)                                                                                                                      |
+| `shipping_address` | array   | List of Shipping Address fields. See [Shipping Address Properties](#shipping-address-properties)                                                                                                                   |
+
+### Billing Address Properties ###
+
+|  Attribute   |  Type  |                     Description                     |
+| ------------ | ------ | --------------------------------------------------- |
+| `first_name` | string | First name                                          |
+| `last_name`  | string | Last name                                           |
+| `company`    | string | Company name                                        |
+| `address_1`  | string | Address line 1                                      |
+| `address_2`  | string | Address line 2                                      |
+| `city`       | string | City name                                           |
+| `state`      | string | ISO code or name of the state, province or district |
+| `postcode`   | string | Postal code                                         |
+| `country`    | string | ISO code of the country                             |
+| `email`      | string | Email address                                       |
+| `phone`      | string | Phone                                               |
+
+### Shipping Address Properties ###
+
+|  Attribute   |  Type  |                     Description                     |
+| ------------ | ------ | --------------------------------------------------- |
+| `first_name` | string | First name                                          |
+| `last_name`  | string | Last name                                           |
+| `company`    | string | Company name                                        |
+| `address_1`  | string | Address line 1                                      |
+| `address_2`  | string | Address line 2                                      |
+| `city`       | string | City name                                           |
+| `state`      | string | ISO code or name of the state, province or district |
+| `postcode`   | string | Postal code                                         |
+| `country`    | string | ISO code of the country                             |
+
+## Create A Customer ##
+
+This API helps you to create a new customer.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-post">POST</i>
+		<h6>/wc-api/v2/customers</h6>
+	</div>
+</div>
+
+```shell
+curl -X POST https://example.com/wc-api/v2/customers \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "customer": {
+    "email": "john.doe@example.com",
+    "first_name": "John",
+    "last_name": "Doe",
+    "username": "john.doe",
+    "billing_address": {
+      "first_name": "John",
+      "last_name": "Doe",
+      "company": "",
+      "address_1": "969 Market",
+      "address_2": "",
+      "city": "San Francisco",
+      "state": "CA",
+      "postcode": "94103",
+      "country": "US",
+      "email": "john.doe@example.com",
+      "phone": "(555) 555-5555"
+    },
+    "shipping_address": {
+      "first_name": "John",
+      "last_name": "Doe",
+      "company": "",
+      "address_1": "969 Market",
+      "address_2": "",
+      "city": "San Francisco",
+      "state": "CA",
+      "postcode": "94103",
+      "country": "US"
+    }
+  }
+}'
+```
+
+```javascript
+var data = {
+  customer: {
+    email: 'john.doe@example.com',
+    first_name: 'John',
+    last_name: 'Doe',
+    username: 'john.doe',
+    billing_address: {
+      first_name: 'John',
+      last_name: 'Doe',
+      company: '',
+      address_1: '969 Market',
+      address_2: '',
+      city: 'San Francisco',
+      state: 'CA',
+      postcode: '94103',
+      country: 'US',
+      email: 'john.doe@example.com',
+      phone: '(555) 555-5555'
+    },
+    shipping_address: {
+      first_name: 'John',
+      last_name: 'Doe',
+      company: '',
+      address_1: '969 Market',
+      address_2: '',
+      city: 'San Francisco',
+      state: 'CA',
+      postcode: '94103',
+      country: 'US'
+    }
+  }
+};
+
+WooCommerce.post('customers', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "customer": {
+        "email": "john.doe@example.com",
+        "first_name": "John",
+        "last_name": "Doe",
+        "username": "john.doe",
+        "billing_address": {
+            "first_name": "John",
+            "last_name": "Doe",
+            "company": "",
+            "address_1": "969 Market",
+            "address_2": "",
+            "city": "San Francisco",
+            "state": "CA",
+            "postcode": "94103",
+            "country": "US",
+            "email": "john.doe@example.com",
+            "phone": "(555) 555-5555"
+        },
+        "shipping_address": {
+            "first_name": "John",
+            "last_name": "Doe",
+            "company": "",
+            "address_1": "969 Market",
+            "address_2": "",
+            "city": "San Francisco",
+            "state": "CA",
+            "postcode": "94103",
+            "country": "US"
+        }
+    }
+}
+
+print(wcapi.post("customers", data).json())
+```
+
+```php
+<?php
+$data = array(
+    'customer' => array(
+        'email' => 'john.doe@example.com',
+        'first_name' => 'John',
+        'last_name' => 'Doe',
+        'username' => 'john.doe',
+        'billing_address' => array(
+            'first_name' => 'John',
+            'last_name' => 'Doe',
+            'company' => '',
+            'address_1' => '969 Market',
+            'address_2' => '',
+            'city' => 'San Francisco',
+            'state' => 'CA',
+            'postcode' => '94103',
+            'country' => 'US',
+            'email' => 'john.doe@example.com',
+            'phone' => '(555) 555-5555'
+        ),
+        'shipping_address' => array(
+            'first_name' => 'John',
+            'last_name' => 'Doe',
+            'company' => '',
+            'address_1' => '969 Market',
+            'address_2' => '',
+            'city' => 'San Francisco',
+            'state' => 'CA',
+            'postcode' => '94103',
+            'country' => 'US'
+        )
+    )
+);
+
+print_r($woocommerce->customers->create($data));
+?>
+```
+
+```ruby
+data = {
+  customer: {
+    email: "john.doe@example.com",
+    first_name: "John",
+    last_name: "Doe",
+    username: "john.doe",
+    billing_address: {
+      first_name: "John",
+      last_name: "Doe",
+      company: "",
+      address_1: "969 Market",
+      address_2: "",
+      city: "San Francisco",
+      state: "CA",
+      postcode: "94103",
+      country: "US",
+      email: "john.doe@example.com",
+      phone: "(555) 555-5555"
+    },
+    shipping_address: {
+      first_name: "John",
+      last_name: "Doe",
+      company: "",
+      address_1: "969 Market",
+      address_2: "",
+      city: "San Francisco",
+      state: "CA",
+      postcode: "94103",
+      country: "US"
+    }
+  }
+}
+
+woocommerce.post("customers", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "customer": {
+    "id": 2,
+    "created_at": "2015-01-05T18:34:19Z",
+    "email": "john.doe@example.com",
+    "first_name": "John",
+    "last_name": "Doe",
+    "username": "john.doe",
+    "last_order_id": null,
+    "last_order_date": null,
+    "orders_count": 0,
+    "total_spent": "0.00",
+    "avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
+    "billing_address": {
+      "first_name": "John",
+      "last_name": "Doe",
+      "company": "",
+      "address_1": "969 Market",
+      "address_2": "",
+      "city": "San Francisco",
+      "state": "CA",
+      "postcode": "94103",
+      "country": "US",
+      "email": "john.doe@example.com",
+      "phone": "(555) 555-5555"
+    },
+    "shipping_address": {
+      "first_name": "John",
+      "last_name": "Doe",
+      "company": "",
+      "address_1": "969 Market",
+      "address_2": "",
+      "city": "San Francisco",
+      "state": "CA",
+      "postcode": "94103",
+      "country": "US"
+    }
+  }
+}
+```
+
+## View A Customer ##
+
+This API lets you retrieve and view a specific customer by ID or email.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/customers/&lt;id&gt;</h6>
+	</div>
+</div>
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/customers/email/&lt;email&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/customers/2 \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('customers/2', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("customers/2").json())
+```
+
+```php
+<?php print_r($woocommerce->customers->get(2)); ?>
+```
+
+```ruby
+woocommerce.get("customers/2").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "customer": {
+    "id": 2,
+    "created_at": "2015-01-05T18:34:19Z",
+    "email": "john.doe@example.com",
+    "first_name": "John",
+    "last_name": "Doe",
+    "username": "john.doe",
+    "last_order_id": null,
+    "last_order_date": null,
+    "orders_count": 0,
+    "total_spent": "0.00",
+    "avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
+    "billing_address": {
+      "first_name": "John",
+      "last_name": "Doe",
+      "company": "",
+      "address_1": "969 Market",
+      "address_2": "",
+      "city": "San Francisco",
+      "state": "CA",
+      "postcode": "94103",
+      "country": "US",
+      "email": "john.doe@example.com",
+      "phone": "(555) 555-5555"
+    },
+    "shipping_address": {
+      "first_name": "John",
+      "last_name": "Doe",
+      "company": "",
+      "address_1": "969 Market",
+      "address_2": "",
+      "city": "San Francisco",
+      "state": "CA",
+      "postcode": "94103",
+      "country": "US"
+    }
+  }
+}
+```
+
+## View List Of Customers ##
+
+This API helps you to view all the customers.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/customers</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/customers \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('customers', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("customers").json())
+```
+
+```php
+<?php print_r($woocommerce->customers->get()); ?>
+```
+
+```ruby
+woocommerce.get("customers").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "customers": [
+    {
+      "id": 2,
+      "created_at": "2015-01-05T18:34:19Z",
+      "email": "john.doe@example.com",
+      "first_name": "John",
+      "last_name": "Doe",
+      "username": "john.doe",
+      "last_order_id": 123,
+      "last_order_date": "2015-01-14T16:47:30Z",
+      "orders_count": 10,
+      "total_spent": "1034.58",
+      "avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
+      "billing_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US",
+        "email": "john.doe@example.com",
+        "phone": "(555) 555-5555"
+      },
+      "shipping_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US"
+      }
+    },
+    {
+      "id": 3,
+      "created_at": "2015-01-10T14:25:39Z",
+      "email": "joao.silva@example.com",
+      "first_name": "João",
+      "last_name": "Silva",
+      "username": "joao.silva",
+      "last_order_id": 120,
+      "last_order_date": "2015-01-10T14:26:30Z",
+      "orders_count": 1,
+      "total_spent": "429.00",
+      "avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
+      "billing_address": {
+        "first_name": "João",
+        "last_name": "Silva",
+        "company": "",
+        "address_1": "Av. Brasil, 432",
+        "address_2": "",
+        "city": "Rio de Janeiro",
+        "state": "RJ",
+        "postcode": "12345-000",
+        "country": "BR",
+        "email": "joao.silva@example.com",
+        "phone": "(55) 5555-5555"
+      },
+      "shipping_address": {
+        "first_name": "João",
+        "last_name": "Silva",
+        "company": "",
+        "address_1": "Av. Brasil, 432",
+        "address_2": "",
+        "city": "Rio de Janeiro",
+        "state": "RJ",
+        "postcode": "12345-000",
+        "country": "BR"
+      }
+    }
+  ]
+}
+```
+
+#### Available Filters ####
+
+| Filter |  Type  |                     Description                     |
+| ------ | ------ | --------------------------------------------------- |
+| `role` | string | Customers by status. eg: `customer` or `subscriber` |
+
+## Update A Customer ##
+
+This API lets you make changes to a customer.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-put">PUT</i>
+		<h6>/wc-api/v2/customers/&lt;id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl -X PUT https://example.com/wc-api/v2/customers/2 \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "customer": {
+    "first_name": "James",
+    "billing_address": {
+      "first_name": "James"
+    },
+    "shipping_address": {
+      "first_name": "James"
+    }
+  }
+}'
+```
+
+```javascript
+var data = {
+  customer: {
+    first_name: 'James',
+    billing_address: {
+      first_name: 'James'
+    },
+    shipping_address: {
+      first_name: 'James'
+    }
+  }
+};
+
+WooCommerce.put('customers/2', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "customer": {
+        "first_name": "James",
+        "billing_address": {
+            "first_name": "James"
+        },
+        "shipping_address": {
+            "first_name": "James"
+        }
+    }
+}
+
+print(wcapi.put("customers/2", data).json())
+```
+
+```php
+<?php
+$data = array(
+    'customer' => array(
+        'first_name' => 'James',
+        'billing_address' => array(
+            'first_name' => 'James'
+        ),
+        'shipping_address' => array(
+            'first_name' => 'James'
+        )
+    )
+);
+
+print_r($woocommerce->customers->update(2, $data));
+?>
+```
+
+```ruby
+data = {
+  customer: {
+    first_name: "James",
+    billing_address: {
+      first_name: "James"
+    },
+    shipping_address: {
+      first_name: "James"
+    }
+  }
+}
+
+woocommerce.put("customers/2", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "customer": {
+    "id": 2,
+    "created_at": "2015-01-05T18:34:19Z",
+    "email": "john.doe@example.com",
+    "first_name": "James",
+    "last_name": "Doe",
+    "username": "john.doe",
+    "last_order_id": null,
+    "last_order_date": null,
+    "orders_count": 0,
+    "total_spent": "0.00",
+    "avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
+    "billing_address": {
+      "first_name": "John",
+      "last_name": "Doe",
+      "company": "",
+      "address_1": "969 Market",
+      "address_2": "",
+      "city": "San Francisco",
+      "state": "CA",
+      "postcode": "94103",
+      "country": "US",
+      "email": "john.doe@example.com",
+      "phone": "(555) 555-5555"
+    },
+    "shipping_address": {
+      "first_name": "John",
+      "last_name": "Doe",
+      "company": "",
+      "address_1": "969 Market",
+      "address_2": "",
+      "city": "San Francisco",
+      "state": "CA",
+      "postcode": "94103",
+      "country": "US"
+    }
+  }
+}
+```
+
+## Delete A Customer ##
+
+This API helps you delete a customer.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-delete">DELETE</i>
+		<h6>/wc-api/v2/customers/&lt;id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl -X DELETE https://example.com/wc-api/v2/customers/2 \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.delete('customers/2', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.delete("customers/2").json())
+```
+
+```php
+<?php print_r($woocommerce->customers->delete(2)); ?>
+```
+
+```ruby
+woocommerce.delete("customers/2").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "message": "Permanently deleted customer"
+}
+```
+
+## View Customer Orders ##
+
+This API lets you retrieve the customers orders.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/customers/&lt;id&gt;/orders</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/customers/2/orders \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('customers/2/orders', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("customers/2/orders").json())
+```
+
+```php
+<?php print_r($woocommerce->customers->get_orders(2)); ?>
+```
+
+```ruby
+woocommerce.get("customers/2/orders").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "orders": [
+    {
+      "id": 531,
+      "order_number": 531,
+      "created_at": "2015-01-21T12:02:13Z",
+      "updated_at": "2015-01-21T12:02:13Z",
+      "completed_at": "2015-01-21T12:02:13Z",
+      "status": "on-hold",
+      "currency": "USD",
+      "total": "30.00",
+      "subtotal": "20.00",
+      "total_line_items_quantity": 1,
+      "total_tax": "0.00",
+      "total_shipping": "10.00",
+      "cart_tax": "0.00",
+      "shipping_tax": "0.00",
+      "total_discount": "0.00",
+      "shipping_methods": "Flat Rate",
+      "payment_details": {
+        "method_id": "bacs",
+        "method_title": "Direct Bank Transfer",
+        "paid": false
+      },
+      "billing_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US",
+        "email": "john.doe@example.com",
+        "phone": "(555) 555-5555"
+      },
+      "shipping_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US"
+      },
+      "note": "",
+      "customer_ip": "127.0.0.1",
+      "customer_user_agent": "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:35.0) Gecko/20100101 Firefox/35.0",
+      "customer_id": 2,
+      "view_order_url": "https://example.com/my-account/view-order/531",
+      "line_items": [
+        {
+          "id": 417,
+          "subtotal": "20.00",
+          "subtotal_tax": "0.00",
+          "total": "20.00",
+          "total_tax": "0.00",
+          "price": "20.00",
+          "quantity": 1,
+          "tax_class": null,
+          "name": "Premium Quality",
+          "product_id": 19,
+          "sku": "",
+          "meta": []
+        }
+      ],
+      "shipping_lines": [
+        {
+          "id": 418,
+          "method_id": "flat_rate",
+          "method_title": "Flat Rate",
+          "total": "10.00"
+        }
+      ],
+      "tax_lines": [],
+      "fee_lines": [],
+      "coupon_lines": [],
+      "customer": {
+        "id": 2,
+        "created_at": "2014-11-19T18:34:19Z",
+        "email": "john.doe@example.com",
+        "first_name": "",
+        "last_name": "",
+        "username": "john.doe",
+        "last_order_id": "531",
+        "last_order_date": "2015-01-21T12:02:13Z",
+        "orders_count": 1,
+        "total_spent": "0.00",
+        "avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
+        "billing_address": {
+          "first_name": "John",
+          "last_name": "Doe",
+          "company": "",
+          "address_1": "969 Market",
+          "address_2": "",
+          "city": "San Francisco",
+          "state": "CA",
+          "postcode": "94103",
+          "country": "US",
+          "email": "john.doe@example.com",
+          "phone": "(555) 555-5555"
+        },
+        "shipping_address": {
+          "first_name": "John",
+          "last_name": "Doe",
+          "company": "",
+          "address_1": "969 Market",
+          "address_2": "",
+          "city": "San Francisco",
+          "state": "CA",
+          "postcode": "94103",
+          "country": "US"
+        }
+      }
+    }
+  ]
+}
+```
+
+<aside class="notice">
+	View the <a href="#orders-properties">Orders Properties</a> for more details on this response.
+</aside>
+
+## View Customer Downloads ##
+
+This API lets you retrieve the customers downloads.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/customers/&lt;id&gt;/downloads</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/customers/2/downloads \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('customers/2/downloads', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("customers/2/downloads").json())
+```
+
+```php
+<?php print_r($woocommerce->customers->get_downloads(2)); ?>
+```
+
+```ruby
+woocommerce.get("customers/2/downloads").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "downloads": [
+    {
+      "download_url": "https://example.com/?download_file=96&order=wc_order_9999999999999&email=john.doe@example.com&key=99999999999999999999999999999999",
+      "download_id": "99999999999999999999999999999999",
+      "product_id": 96,
+      "download_name": "Woo Album #4 &ndash; Woo Album",
+      "order_id": 532,
+      "order_key": "wc_order_9999999999999",
+      "downloads_remaining": "5",
+      "access_expires": null,
+      "file": {
+        "name": "Woo Album",
+        "file": "http://example.com/wp-content/uploads/woocommerce_uploads/2015/01/album.zip"
+      }
+    }
+  ]
+}
+```
+
+### Customer Downloads Properties ###
+
+|       Attribute       |   Type  |                                           Description                                           |
+| --------------------- | ------- | ----------------------------------------------------------------------------------------------- |
+| `download_url`        | string  | Download file URL                                                                               |
+| `download_id`         | string  | Download ID                                                                                     |
+| `product_id`          | integer | Downloadable product ID                                                                         |
+| `download_name`       | string  | Downloadable file name                                                                          |
+| `order_id`            | integer | Order ID                                                                                        |
+| `order_key`           | string  | Order Key                                                                                       |
+| `downloads_remaining` | string  | Amount of downloads remaining. An empty string means that is "Unlimited"                        |
+| `access_expires`      | string  | UTC DateTime when the download access expires. `null` means "Never"                             |
+| `file`                | array   | List for downloadable files, each one have a `name` (file name) and `file` (file URL) attribute |
+
+## View Customers Count ##
+
+This API lets you retrieve a count of all customers.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/customers/count</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/customers/count \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('customers/count', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("customers/count").json())
+```
+
+```php
+<?php print_r($woocommerce->customers->get_count()); ?>
+```
+
+```ruby
+woocommerce.get("customers/count").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "count": 10
+}
+```
+
+#### Available Filters ####
+
+| Filter |  Type  |                     Description                     |
+| ------ | ------ | --------------------------------------------------- |
+| `role` | string | Customers by status. eg: `customer` or `subscriber` |
diff --git a/source/includes/v3/_index.md b/source/includes/v3/_index.md
new file mode 100644
index 00000000..a2de9460
--- /dev/null
+++ b/source/includes/v3/_index.md
@@ -0,0 +1,409 @@
+# Index #
+
+The API index provides information about the endpoints available for the site, as well as store-specific information. No authentication is required to access the API index, however if the REST API is disabled, you will receive a `404 Not Found` error.
+
+> 404 Not Found response:
+
+```json
+{
+  "errors" : [
+    {
+      "code" : "woocommerce_api_disabled",
+      "message" : "The WooCommerce API is disabled on this site"
+    }
+  ]
+}
+```
+
+## Index Properties ##
+
+|   Attribute   |  Type  |                                                                    Description                                                                    |
+| ------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `name`        | string | The name of the site - `get_option( 'blogname' )`                                                                                                 |
+| `description` | string | The site's description - `get_option( 'blogdescription' )`                                                                                        |
+| `URL`         | string | The site's URL - `get_option( 'siteurl' )`                                                                                                        |
+| `wc_version`  | string | The active WooCommerce version                                                                                                                    |
+| `routes`      | array  | A list of available endpoints for the site keyed by relative URL. Each endpoint specifies the HTTP methods supported as well as the canonical URL |
+| `meta`        | array  | A list of WooCommerce settings used in the API. See [Meta Properties](#meta-properties)                                                           |
+
+### Meta Properties ###
+
+|      Attribute       |   Type  |                                               Description                                                |
+| -------------------- | ------- | -------------------------------------------------------------------------------------------------------- |
+| `timezone`           | string  | The site's timezone                                                                                      |
+| `currency`           | string  | Currency ISO Code, e.g. `GBP`                                                                            |
+| `currency_format`    | string  | Currency symbol, HTML encoded, e.g. `£`                                                                  |
+| `price_num_decimals` | integer | Number of decimals                                                                                       |
+| `tax_included`       | boolean | True if prices include tax, false otherwise                                                              |
+| `weight_unit`        | string  | The unit set for product weights. Valid units are `kg`, `g`, `lbs`, `oz`                                 |
+| `dimension_unit`     | string  | The unit set for product dimensions. Valid units are `cm`, `m`, `cm`, `mm`, `in`, and `yd`               |
+| `ssl_enabled`        | boolean | True if SSL is enabled for the site, false otherwise                                                     |
+| `permalinks_enabled` | boolean | Whether pretty permalinks are enabled on the site, if this is false, the API will not function correctly |
+| `links`              | array   | API help links list                                                                                      |
+
+
+## View Index List ##
+
+Retrieve a set of store information.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2 \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("").json())
+```
+
+```php
+<?php print_r($woocommerce->index->get()); ?>
+```
+
+```ruby
+woocommerce.get("").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "store": {
+    "name": "WooCommerce",
+    "description": "Just a WooCommerce store",
+    "URL": "http://example.com",
+    "wc_version": "2.3.0",
+    "routes": {
+      "/": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ],
+        "meta": {
+          "self": "https://example.com/wc-api/v2/"
+        }
+      },
+      "/customers": {
+        "supports": [
+          "HEAD",
+          "GET",
+          "POST"
+        ],
+        "meta": {
+          "self": "https://example.com/wc-api/v2/customers"
+        },
+        "accepts_data": true
+      },
+      "/customers/count": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ],
+        "meta": {
+          "self": "https://example.com/wc-api/v2/customers/count"
+        }
+      },
+      "/customers/<id>": {
+        "supports": [
+          "HEAD",
+          "GET",
+          "POST",
+          "PUT",
+          "PATCH",
+          "DELETE"
+        ],
+        "accepts_data": true
+      },
+      "/customers/email/<email>": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ]
+      },
+      "/customers/<id>/orders": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ]
+      },
+      "/customers/<id>/downloads": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ]
+      },
+      "/orders": {
+        "supports": [
+          "HEAD",
+          "GET",
+          "POST"
+        ],
+        "meta": {
+          "self": "https://example.com/wc-api/v2/orders"
+        },
+        "accepts_data": true
+      },
+      "/orders/count": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ],
+        "meta": {
+          "self": "https://example.com/wc-api/v2/orders/count"
+        }
+      },
+      "/orders/statuses": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ],
+        "meta": {
+          "self": "https://example.com/wc-api/v2/orders/statuses"
+        }
+      },
+      "/orders/<id>": {
+        "supports": [
+          "HEAD",
+          "GET",
+          "POST",
+          "PUT",
+          "PATCH",
+          "DELETE"
+        ],
+        "accepts_data": true
+      },
+      "/orders/<order_id>/notes": {
+        "supports": [
+          "HEAD",
+          "GET",
+          "POST"
+        ],
+        "accepts_data": true
+      },
+      "/orders/<order_id>/notes/<id>": {
+        "supports": [
+          "HEAD",
+          "GET",
+          "POST",
+          "PUT",
+          "PATCH",
+          "DELETE"
+        ],
+        "accepts_data": true
+      },
+      "/orders/<order_id>/refunds": {
+        "supports": [
+          "HEAD",
+          "GET",
+          "POST"
+        ],
+        "accepts_data": true
+      },
+      "/orders/<order_id>/refunds/<id>": {
+        "supports": [
+          "HEAD",
+          "GET",
+          "POST",
+          "PUT",
+          "PATCH",
+          "DELETE"
+        ],
+        "accepts_data": true
+      },
+      "/products": {
+        "supports": [
+          "HEAD",
+          "GET",
+          "POST"
+        ],
+        "meta": {
+          "self": "https://example.com/wc-api/v2/products"
+        },
+        "accepts_data": true
+      },
+      "/products/count": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ],
+        "meta": {
+          "self": "https://example.com/wc-api/v2/products/count"
+        }
+      },
+      "/products/<id>": {
+        "supports": [
+          "HEAD",
+          "GET",
+          "POST",
+          "PUT",
+          "PATCH",
+          "DELETE"
+        ],
+        "accepts_data": true
+      },
+      "/products/<id>/reviews": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ]
+      },
+      "/products/categories": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ],
+        "meta": {
+          "self": "https://example.com/wc-api/v2/products/categories"
+        }
+      },
+      "/products/categories/<id>": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ]
+      },
+      "/products/sku/<sku>": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ]
+      },
+      "/coupons": {
+        "supports": [
+          "HEAD",
+          "GET",
+          "POST"
+        ],
+        "meta": {
+          "self": "https://example.com/wc-api/v2/coupons"
+        },
+        "accepts_data": true
+      },
+      "/coupons/count": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ],
+        "meta": {
+          "self": "https://example.com/wc-api/v2/coupons/count"
+        }
+      },
+      "/coupons/<id>": {
+        "supports": [
+          "HEAD",
+          "GET",
+          "POST",
+          "PUT",
+          "PATCH",
+          "DELETE"
+        ],
+        "accepts_data": true
+      },
+      "/coupons/code/<code>": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ]
+      },
+      "/reports": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ],
+        "meta": {
+          "self": "https://example.com/wc-api/v2/reports"
+        }
+      },
+      "/reports/sales": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ],
+        "meta": {
+          "self": "https://example.com/wc-api/v2/reports/sales"
+        }
+      },
+      "/reports/sales/top_sellers": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ],
+        "meta": {
+          "self": "https://example.com/wc-api/v2/reports/sales/top_sellers"
+        }
+      },
+      "/webhooks": {
+        "supports": [
+          "HEAD",
+          "GET",
+          "POST"
+        ],
+        "meta": {
+          "self": "https://example.com/wc-api/v2/webhooks"
+        },
+        "accepts_data": true
+      },
+      "/webhooks/count": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ],
+        "meta": {
+          "self": "https://example.com/wc-api/v2/webhooks/count"
+        }
+      },
+      "/webhooks/<id>": {
+        "supports": [
+          "HEAD",
+          "GET",
+          "POST",
+          "PUT",
+          "PATCH",
+          "DELETE"
+        ],
+        "accepts_data": true
+      },
+      "/webhooks/<webhook_id>/deliveries": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ]
+      },
+      "/webhooks/<webhook_id>/deliveries/<id>": {
+        "supports": [
+          "HEAD",
+          "GET"
+        ]
+      }
+    },
+    "meta": {
+      "timezone": "America/Sao_Paulo",
+      "currency": "USD",
+      "currency_format": "&#36;",
+      "price_num_decimals": "2",
+      "tax_included": false,
+      "weight_unit": "kg",
+      "dimension_unit": "cm",
+      "ssl_enabled": false,
+      "permalinks_enabled": true,
+      "links": {
+        "help": "http://woothemes.github.io/woocommerce-rest-api-docs/"
+      }
+    }
+  }
+}
+```
diff --git a/source/includes/v3/_introduction.md b/source/includes/v3/_introduction.md
new file mode 100644
index 00000000..5bf44cba
--- /dev/null
+++ b/source/includes/v3/_introduction.md
@@ -0,0 +1,507 @@
+# Introduction #
+
+Introduced in WooCommerce 2.1, the REST API allows store data to be created, read, updated, and deleted using the JSON format.
+
+## Requirements ##
+
+You must be using WooCommerce 2.1 or newer and the REST API must be enabled under `WooCommerce > Settings`. You must enable pretty permalinks, as default permalinks will not work.
+
+<aside class="notice">
+Many endpoints were improving with new versions of WooCommerce, so we always recommend keeping your WooCommerce updated to work properly with this documentation.
+</aside>
+
+## Version ##
+
+The current API version is `v3` which takes a first-order position in endpoints.
+
+Check the API versions present in every version of WooCommerce:
+
+| API Version |          WooCommerce          |
+| ----------- | ----------------------------- |
+| `v1`        | 2.1.x, 2.2.x, 2.3.x and 2.4.x |
+| `v2`        | 2.2.x, 2.3.x and 2.4.x        |
+| `v3`        | 2.4.x                         |
+
+The `v1` and `v2` will be removed in future versions.
+
+### Differences between v1 and v2 versions ###
+
+* v1 supports XML response format, v2 only supports JSON.
+* v1 does not support creating or updating (with the exception of order status) any resources, v2 supports full create/read/update/delete for all endpoints.
+* v1 does not include order item meta, v2 includes full order item meta (with an optional `filter` parameter to include protected order item meta)
+* v1 does not include any endpoints for listing a customer's available downloads, v2 includes the `GET /customer/{id}/downloads` endpoint.
+* v1 includes an endpoint for listing notes for an order, v2 includes full create/read/update/delete endpoints.
+* v1 does not include any endpoints for listing product categories, v2 includes two endpoints for product categories (`GET /products/categories` and `GET /products/categories/{id}`).
+* v1 does not include any endpoints for getting valid order statuses, v2 includes an endpoint for listing valid order statuses (`GET /orders/statuses`).
+* v2 supports the core features added in WooCommerce 2.2, primarily order refunds (via the `/orders/refunds` endpoint) and Webhooks (via the `/webhooks`).
+
+### Differences between v3 and old versions ###
+
+* v3 implement full basic authentication ([conforms to the Basic auth spec)](http://www.w3.org/Protocols/HTTP/1.0/spec.html)).
+* v3 fixes the OAuth implementation to be compliant with the [Oauth 1.0a specs](http://tools.ietf.org/html/rfc5849).
+* v3 include a new endpoint to get all product orders.
+* v3 have new endpoints to allow bulk actions as edition and creation of products, orders, customers and coupons.
+* v3 introduce new product attribute endpoints (`GET`, `POST`, `PUT` and `DELETE`).
+* v3 deprecated the product/sku/&lt;id&gt; endpoint (because a SKU can be generated with any character, besides that there is a filter callend `filter[sku]`).
+* v3 include category thumbnails on the requests for `product/categories`.
+* v3 uses our option to auto generate passwords for new customers.
+
+### API Docs for each version ###
+
+* [WooCommerce REST API v1 docs](v1.html)
+* [WooCommerce REST API v2 docs](v2.html)
+* [WooCommerce REST API v3 docs](index.html)
+
+## Schema ##
+
+The API is accessible via this endpoint:
+
+`https://www.your-store.com/wc-api/v3`
+
+You may access the API over either HTTP or HTTPS. HTTPS is recommended where possible, as authentication is simpler. The API index will declare if the site supports SSL or not.
+
+## Requests/Responses ##
+
+The default response format is JSON. Requests with a message-body use plain JSON to set or update resource attributes. Successful requests will return a `200 OK` HTTP status.
+
+Some general information about responses:
+
+* Dates are returned in [RFC3339](http://www.ietf.org/rfc/rfc3339.txt) format in UTC timezone: `YYYY-MM-DDTHH:MM:SSZ`
+
+* Resource IDs are returned as integers.
+
+* Any decimal monetary amount, such as prices or totals, are returned as strings with two decimal places. The decimal separator (typically either `.` or `,`) is controlled by the site and is included in the API index. This is by design, in order to make localization of API data easier for the client. You may need to account for this in your implemetation if you will be doing calculations with the returned data (e.g. convert string amounts with commas as the decimal place before performing any calculations)
+
+* Other amounts, such as item counts, are returned as integers.
+
+* Blank fields are generally included as `null` instead of being blank strings or omitted.
+
+## Authentication ##
+
+There are two aways to authenticate with the API, depending on whether the site supports SSL or not.  Remember that the Index endpoint will indicate if the site supports SSL or not.
+
+### Over HTTPS ###
+
+You may use [HTTP Basic Auth](http://en.wikipedia.org/wiki/Basic_access_authentication) by providing the API Consumer Key as the username and the API Consumer Secret as the password.
+
+> HTTP Basic Auth example
+
+```shell
+curl https://www.example.com/wc-api/v2/orders \
+    -u consumer_key:consumer_secret
+```
+
+Occasionally some servers may not properly parse the Authorization header (if you see a "Consumer key is missing" error when authenticating over SSL, you have a server issue). In this case, you may provide the consumer key/secret as query string parameters.
+
+> Example for servers that not properly parse the Authorization header:
+
+```shell
+curl https://www.example.com/wc-api/v2/orders?consumer_key=123&consumer_secret=abc
+```
+
+### Over HTTP ###
+
+You must use [OAuth 1.0a "one-legged" authentication](http://tools.ietf.org/html/rfc5849) to ensure API credentials cannot be intercepted. Typically you may use any standard OAuth 1.0a library in your language of choice to handle the authentication, or generate the necessary parameters by following these instructions.
+
+#### Generating an OAuth signature ####
+
+1) Set the HTTP method for the request:
+
+`GET`
+
+2) Set your base request URI -- this is the full request URI without query string parameters -- and URL encode according to RFC 3986:
+
+`http://www.example.com/wc-api/v1/orders`
+
+when encoded:
+
+`http%3A%2F%2Fwww.example.com%2Fwc-api%2Fv1%2Forders`
+
+3) Collect and normalize your query string parameters. This includes all `oauth_*` parameters except for the signature. Parameters should be normalized by URL encoding according to RFC 3986 (`rawurlencode` in PHP) and percent(`%`) characters should be double-encoded (e.g. `%` becomes `%25`.
+
+4) Sort the parameters in byte-order (`uksort( $params, 'strcmp' )` in PHP)
+
+5) Join each parameter with an encoded equals sign (`%3D`):
+
+`oauth_signature_method%3DHMAC-SHA1`
+
+6) Join each parameter key/value with an encoded ampersand (`%26`):
+
+`oauth_consumer_key%3Dabc123%26oauth_signature_method%3DHMAC-SHA1`
+
+7) Form the string to sign by joining the HTTP method, encoded base request URI, and encoded parameter string with an unencoded ampersand symbol (&):
+
+`GET&http%3A%2F%2Fwww.example.com%2Fwc-api%2Fv1%2Forders&oauth_consumer_key%3Dabc123%26oauth_signature_method%3DHMAC-SHA1`
+
+8) Generate the signature using the string to key and your consumer secret key
+
+If you are having trouble generating a correct signature, you'll want to review your string to sign for errors with encoding. The [authentication source](https://github.com/woothemes/woocommerce/blob/master/includes/api/class-wc-api-authentication.php#L177) can also be helpful in understanding how to properly generate the signature.
+
+#### OAuth Tips ####
+
+* The OAuth parameters must be added as query string parameters and *not* included in the Authorization header. This is because there is no reliable cross-platform way to get the raw request headers in WordPress.
+* The require parameters are: `oauth_consumer_key`, `oauth_timestamp`, `oauth_nonce`, `oauth_signature`, and `oauth_signature_method`. `oauth_version` is not required and must be omitted.
+* HMAC-SHA1 or HMAC-SHA256 are the only accepted hash algorithms.
+* The OAuth nonce can be any randomly generated 32 character (recommended) string that is unique to the consumer key. Read more suggestions on [generating a nonce](https://dev.twitter.com/discussions/12445) on the Twitter API forums.
+* The OAuth timestamp should be the unix timestamp at the time of the request. The API will deny any requests that include a timestamp that is outside of a 15 minute window to prevent replay attacks.
+* You must use the store URL provided by the index when forming the base string used for the signature, as this is what the server will use. (e.g. if the store URL includes a `www` sub-domain, you should use it for requests)
+* Some OAuth libraries add an ampersand to the provided secret key before generating the signature. WooCommerce does *not* adhere to the OAuth spec in this regard and the ampersand should be removed prior to generating the signature. An ampersand at the end of the string will result in an invalid signature.
+* You may test your generated signature using LinkedIn's [OAuth test console](http://developer.linkedinlabs.com/oauth-test/) -- leave the member token/secret blank.
+* Twitter has great instructions on [generating a signature](https://dev.twitter.com/docs/auth/creating-signature) with OAuth 1.0a, but remember tokens are not used with this implementation.
+* Note that the request body is *not* signed as per the OAuth spec, see [Google's OAuth 1.0 extension](https://oauth.googlecode.com/svn/spec/ext/body_hash/1.0/oauth-bodyhash.html) for details on why.
+* If including filter fields in your request, it saves a lot of trouble if you can order your filter fields alphabetically before submitting. Many Oauth libraries won't order subquery fields properly, resulting in invalid signatures.
+
+## Parameters ##
+
+All endpoints accept optional parameters which can be passed as an HTTP query string parameter, e.g. `GET /orders?status=completed`. There are common parameters and endpoint-specific parameters which are documented along with that endpoint.
+
+### Filter Parameter ###
+
+All endpoints accept a `filter` parameter that scopes individual filters using brackets, like date filtering:
+
+`GET /orders?filter[created_at_min]=2013-11-01`
+
+Multiple `filter` parameters can be included and intermixed with other parameters:
+
+`GET /orders?status=completed&filter[created_at_min]=2013-11-01&filter[created_at_max]=2013-11-30`
+
+Note that the following filters are supported for all endpoints except the `reports` endpoint, which has it's own set of filters that are documented along with that endpoint.
+
+#### Available Filters ####
+
+|       Filter       |                                                                                                                                         Description                                                                                                                                          |
+| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `created_at_min`   | given a date, only resources *created after the provided date* will be returned                                                                                                                                                                                                              |
+| `created_at_max`   | given a date, only resources *created before the provided date* will be returned                                                                                                                                                                                                             |
+| `updated_at_min`   | given a date, only resources *updated after the provided date* will be returned                                                                                                                                                                                                              |
+| `updated_at_max`   | given a date, only resources *updated before the provided date* will be returned                                                                                                                                                                                                             |
+| `q`                | performs a keyword search and returns resources that match, e.g. `GET /products?filter[q]=search-keyword`. Note that search terms should be URL-encoded as they will be decoded internally with [`urldecode`](http://us3.php.net/manual/en/function.urldecode.php)                           |
+| `order`            | controls the ordering of the resources returned, accepted values are `ASC` (default) or `DESC`                                                                                                                                                                                               |
+| `orderby`          | controls the field that is used for ordering the resources returned. Accepts the same arguments as [`WP_Query`](http://codex.wordpress.org/Class_Reference/WP_Query#Order_.26_Orderby_Parameters). Defaults to `date`. You can order by `meta_value` but you must provide `orderby_meta_key` |
+| `orderby_meta_key` | the meta key to order returned resources by when using `orderby=meta_value`. For example, you could order products by price using `GET /products?filter[orderby]=meta_value&filter[orderby_meta_key]=_price`                                                                                 |
+| `post_status`      | limits resources to only those with the specified post status. Most useful for returning unpublished products, e.g. `GET /products?filter[post_status]=draft`                                                                                                                                |
+| `meta`             | resource meta is excluded by default, but it can be included by setting `meta=true`, e.g. `GET /orders?filter[meta]=true`. Protected meta (meta whose key is prefixed with an underscore) is not included in the response                                                                    |
+| `pagination`       | explained below                                                                                                                                                                                                                                                                              |
+
+Note that Dates should be provided in [RFC3339](http://www.ietf.org/rfc/rfc3339.txt) format in UTC timezone: `YYYY-MM-DDTHH:MM:SSZ`. You may omit the time and timezone if desired.
+
+### Fields Parameter ###
+
+You may limit the fields returned in the response using the `fields` parameter:
+
+`GET /orders?fields=id`
+
+To include multiple fields, separate them with commas:
+
+`GET /orders?fields=id,status`
+
+You can specify sub-fields using dot-notation:
+
+`GET /orders?fields=id,status,payment_details.method_title`
+
+Sub-fields can't be limited for resources that have multiple structs, like an order's line items. For example, this will return just the line items, but each line item will have the full set of information, not just the product ID:
+
+`GET /orders?fields=line_items.product_id`
+
+## Pagination ##
+
+Requests that return multiple items will be paginated to 10 items by default. This default can be changed by the site administrator by changing the `posts_per_page` option. Alternatively the items per page can be specifed with the `?filter[limit]` parameter:
+
+`GET /orders?filter[limit]=15`
+
+You can specify further pages with the `?page` parameter:
+
+`GET /orders?page=2`
+
+You may also specify the offset from the first resource using the `?filter[offset]` parameter:
+
+`GET /orders?filter[offset]=5`
+
+Page number is 1-based and ommiting the `?page` parameter will return the first page.
+
+The total number of resources and pages are always included in the `X-WC-Total` and `X-WC-TotalPages` HTTP headers.
+
+## Link Header ##
+
+Pagination info is included in the [Link Header](http://tools.ietf.org/html/rfc5988). It's recommended that you follow these values instead of building your own URLs where possible.
+
+```
+Link: <https://www.example.com/wc-api/v1/products?page=2>; rel="next",
+<https://www.example.com/wc-api/v1/products?page=3>; rel="last"`
+```
+
+*Linebreak included for readability*
+
+The possible `rel` values are:
+
+|  Value  |                       Description                       |
+|---------|---------------------------------------------------------|
+| `next`  | Shows the URL of the immediate next page of results     |
+| `last`  | Shows the URL of the last page of results               |
+| `first` | Shows the URL of the first page of results              |
+| `prev`  | Shows the URL of the immediate previous page of results |
+
+## Errors ##
+
+Occasionally you might encounter errors when accessing the API. There are four possible types:
+
+* Invalid requests, such as using an unsupported HTTP method will result in `400 Bad Request`.
+* Authentication or permission errors, such as incorrect API keys will result in `401 Unauthorized`.
+* Requests to resources that don't exist or are missing required parameters will result in `404 Not Found`.
+* Requests that cannot be processed due to a server error will result in `500 Internal Server Error`.
+
+> `400 Bad Request` example:
+
+```json
+{
+  "errors" : [
+    {
+      "code" : "woocommerce_api_unsupported_method",
+      "message" : "Unsupported request method"
+    }
+  ]
+}
+```
+
+> `401 Unauthorized` example:
+
+```json
+{
+  "errors" : [
+    {
+      "code" : "woocommerce_api_authentication_error",
+      "message" : "Consumer Key is invalid"
+    }
+  ]
+}
+```
+
+> `404 Not Found` example:
+
+```json
+{
+  "errors" : [
+    {
+      "code" : "woocommerce_api_invalid_order",
+      "message" : "Invalid order"
+    }
+  ]
+}
+```
+
+> `500 Internal Server Error` example:
+
+```json
+{
+  "errors" : [
+    {
+      "code" : "woocommerce_api_invalid_handler",
+      "message" : "The handler for the route is invalid"
+    }
+  ]
+}
+```
+
+Errors return both an appropriate HTTP status code and response object which contains a `code` and `message` attribute. If an endpoint has any custom errors, they are documented with that endpoint.
+
+## HTTP Verbs ##
+
+The API uses the appropriate HTTP verb for each action:
+
+|  Verbe   |                               Description                               |
+|----------|-------------------------------------------------------------------------|
+| `HEAD`   | Can be used for any endpoint to return just the HTTP header information |
+| `GET`    | Used for retrieving resources                                           |
+| `PUT`    | Used for updating resources                                             |
+| `POST`   | Used for creating resources                                             |
+| `DELETE` | Used for deleting resources                                             |
+
+## JSONP Support ##
+
+The API supports JSONP by default. JSONP responses uses the `application/javascript` content-type. You can specify the callback using the `?_jsonp` parameter for `GET` requests to have the response wrapped in a JSON function:
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/orders/count?_jsonp=ordersCount</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/orders/count?_jsonp=ordersCount \
+	-u consumer_key:consumer_secret
+```
+
+> Response:
+
+```
+\**\ordersCount({"count":8})
+```
+
+> If the site administrator has chosen to disable it, you will receive a `400 Bad Request` error:
+
+```json
+{
+  "errors": [
+    {
+      "code": "woocommerce_api_jsonp_disabled",
+      "message": "JSONP support is disabled on this site"
+    }
+  ]
+}
+```
+
+> If your callback contains invalid characters, you will receive a `400 Bad Request` error:
+
+
+```json
+{
+  "errors": [
+    {
+      "code": "woocommerce_api_jsonp_callback_invalid",
+      "message": "The JSONP callback function is invalid"
+    }
+  ]
+}
+```
+
+## Webhooks ##
+
+Webhooks are an experimental feature in the v2 REST API. They must be managed using the REST API endpoints as a UI is not yet available. The `WC_Webhook` class manages all data storage/retrieval from the custom post type, as well as enqueuing a webhook's actions and processing/delivering/logging the webhook. On `woocommerce_init`, active webhooks are loaded and their associated hooks are added.
+
+Each webhook has:
+
+* status: active (delivers payload), paused (delivery paused by admin), disabled (delivery paused by failure)
+* topic: determines which resource events the webhook is triggered for
+* delivery URL: URL where the payload is delivered, must be HTTP or HTTPS
+* secret: an optional secret key that is used to generate a HMAC-SHA256 hash of the request body so the receiver can verify authenticity of the webhook
+* hooks: an array of hook names that are added and bound to the webhook for processing
+
+### Topics ###
+
+The topic is a combination resource (e.g. order) and event (e.g. created) and maps to one or more hook names (e.g. `woocommerce_checkout_order_processed`). Webhooks can be created using the topic name and the appropriate hooks are automatically added.
+
+Core topics are:
+
+* `coupon.created, coupon.updated, coupon.deleted`
+* `customer.created, customer.updated, customer.deleted`
+* `order.created, order.updated, order.deleted`
+* `product.created, product.updated, product.deleted`
+
+Custom topics can also be used which map to a single hook name, so for example you could add a webhook with topic `action.woocommerce_add_to_cart` that is triggered on that event. Custom topics pass the first hook argument to the payload, so in this example the `cart_item_key` would be included in the payload.
+
+### Delivery/Payload ###
+
+Delivery is done using `wp_remote_post()` (HTTP POST) and processed in the background by default using wp-cron. A few custom headers are added to the request to help the receiver process the webhook:
+
+* `X-WC-Webhook-Topic` - e.g. `order.updated`
+* `X-WC-Webhook-Resource` - e.g. `order`
+* `X-WC-Webhook-Event` - e.g. `updated`
+* `X-WC-Webhook-Signature` - a base64 encoded HMAC-SHA256 hash of the payload
+* `X-WC-Webhook-ID` - webhook's post ID
+* `X-WC-Delivery-ID` - delivery log ID (a comment)
+
+The payload is JSON encoded and for API resources (coupons,customers,orders,products), the response is exactly the same as if requested via the REST API.
+
+### Logging ###
+
+Requests/responses are logged as comments on the webhook custom post type. Each delivery log includes:
+
+* Request duration
+* Request URL, method, headers, and body
+* Response Code, message, headers, and body
+
+Only the 25 most recent delivery logs are kept in order to reduce comment table bloat.
+
+After 5 consecutive failed deliveries (as defined by a non HTTP 2xx response code), the webhook is disabled and must be edited via the REST API to re-enable.
+
+Delivery logs can be fetched through the REST API endpoint or in code using `WC_Webhook::get_delivery_logs()`
+
+### Endpoints ###
+
+See the webhook resource section.
+
+## Troubleshooting ##
+
+* Nginx - Older configurations of Nginx can cause issues with the API, see [this issue](https://github.com/woothemes/woocommerce/issues/5616#issuecomment-47338737) for details
+
+## Official Libraries ##
+
+- [Node.js](https://www.npmjs.com/package/woocommerce-api)
+- [Python](https://pypi.python.org/pypi/WooCommerce)
+- [PHP](https://packagist.org/packages/woothemes/woocommerce-api)
+- [Ruby](https://rubygems.org/gems/woocommerce_api)
+
+```javascript
+// Install:
+// npm install --save woocommerce-api
+
+// Setup:
+var WooCommerceAPI = require('woocommerce-api');
+
+var WooCommerce = new WooCommerceAPI({
+  url: 'http://example.com', // Your store URL
+  consumerKey: 'consumer_key', // Your consumer key
+  consumerSecret: 'consumer_secret', // Your consumer secret
+  version: 'v2' // WooCommerce API version
+});
+```
+
+```python
+# Install:
+# pip install woocommerce
+
+# Setup:
+from woocommerce import API
+
+wcapi = API(
+    url="http://example.com",
+    consumer_key="consumer_key",
+    consumer_secret="consumer_secret",
+    version="v2"
+)
+```
+
+```php
+<?php
+// Install:
+// composer require "woothemes/woocommerce-api:2.*"
+
+// Setup:
+include_once('vendor/autoload.php');
+
+$woocommerce = new WC_API_Client(
+    'http://example.com/',
+    'consumer_key',
+    'consumer_secret'
+);
+?>
+```
+
+```ruby
+# Install:
+# gem install woocommerce_api
+
+# Setup:
+require "woocommerce_api"
+
+woocommerce = WooCommerce::API.new(
+  "http://example.com",
+  "consumer_key",
+  "consumer_secret",
+  {
+    version: "v2"
+  }
+)
+```
+
+<aside class="notice">
+	Use the tabs at the top-right corner to see how to install and use each library.
+</aside>
+
+## Tools ##
+
+* [CocoaRestClient](http://mmattozzi.github.io/cocoa-rest-client/) - A free, easy to use Mac OS X GUI client for interacting with the API, most useful when your test store has SSL enabled.
+* [Paw HTTP Client](https://itunes.apple.com/us/app/paw-http-client/id584653203?mt=12) - Another excellent HTTP client for Mac OS X.
+* [RESTClient, a debugger for RESTful web services](https://addons.mozilla.org/en-US/firefox/addon/restclient/) - Free Firefox add-on.
+* [Advanced REST client](https://chrome.google.com/webstore/detail/advanced-rest-client/hgmloofddffdnphfgcellkdfbfbjeloo) - Free Google Chrome extension.
diff --git a/source/includes/v3/_orders.md b/source/includes/v3/_orders.md
new file mode 100644
index 00000000..a76dbcbf
--- /dev/null
+++ b/source/includes/v3/_orders.md
@@ -0,0 +1,2217 @@
+# Orders #
+
+This section lists all API that can be used to create, edit or otherwise manipulate orders.
+
+## Orders Properties ##
+
+|          Attribute          |   Type  |                                                                                                Description                                                                                                |
+| --------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `id`                        | integer | Order ID (post ID) <i class="label label-info">read-only</i>                                                                                                                                              |
+| `order_number`              | integer | Order number                                                                                                                                                                                              |
+| `created_at`                | string  | UTC DateTime when the order was created <i class="label label-info">read-only</i>                                                                                                                         |
+| `updated_at`                | string  | UTC DateTime when the order was last updated <i class="label label-info">read-only</i>                                                                                                                    |
+| `completed_at`              | string  | UTC DateTime when the order was last completed <i class="label label-info">read-only</i>                                                                                                                  |
+| `status`                    | string  | Order status. By default are available the status: `pending`, `processing`, `on-hold`, `completed`, `cancelled`, `refunded` and `failed`. See [View List of Order Statuses](#view-list-of-order-statuses) |
+| `currency`                  | string  | Currency in ISO format, e.g `USD`                                                                                                                                                                         |
+| `total`                     | float   | Order total <i class="label label-info">read-only</i>                                                                                                                                                     |
+| `subtotal`                  | float   | Order subtotal <i class="label label-info">read-only</i>                                                                                                                                                  |
+| `total_line_items_quantity` | integer | Total of order items <i class="label label-info">read-only</i>                                                                                                                                            |
+| `total_tax`                 | float   | Order tax total <i class="label label-info">read-only</i>                                                                                                                                                 |
+| `total_shipping`            | float   | Order shipping total <i class="label label-info">read-only</i>                                                                                                                                            |
+| `cart_tax`                  | float   | Order cart tax <i class="label label-info">read-only</i>                                                                                                                                                  |
+| `shipping_tax`              | float   | Order shipping tax <i class="label label-info">read-only</i>                                                                                                                                              |
+| `total_discount`            | float   | Order total discount <i class="label label-info">read-only</i>                                                                                                                                            |
+| `shipping_methods`          | string  | Text list of the shipping methods used in the order <i class="label label-info">read-only</i>                                                                                                             |
+| `payment_details`           | array   | List of payment details. See [Payment Details Properties](#payment-details-properties)                                                                                                                    |
+| `billing_address`           | array   | List of customer billing address. See [Customer Billing Address Properties](#billing-address-properties)                                                                                                  |
+| `shipping_address`          | array   | List of customer shipping address. See [Customer Shipping Address Properties](#shipping-address-properties)                                                                                               |
+| `note`                      | string  | Customer order notes                                                                                                                                                                                      |
+| `customer_ip`               | string  | Customer IP address <i class="label label-info">read-only</i>                                                                                                                                             |
+| `customer_user_agent`       | string  | Customer User-Agent <i class="label label-info">read-only</i>                                                                                                                                             |
+| `customer_id`               | integer | Customer ID (user ID) <i class="label label-info">required</i>                                                                                                                                            |
+| `view_order_url`            | string  | URL to view the order in frontend <i class="label label-info">read-only</i>                                                                                                                               |
+| `line_items`                | array   | List of order line items. See [Line Items Properties](#line-items-properties)                                                                                                                             |
+| `shipping_lines`            | array   | List of shipping line items. See [Shipping Lines Properties](#shipping-lines-properties)                                                                                                                  |
+| `tax_lines`                 | array   | List of tax line items. See [Tax Lines Properties](#tax-lines-properties) <i class="label label-info">read-only</i>                                                                                       |
+| `fee_lines`                 | array   | List of fee line items. See [Fee Lines Properites](#fee-lines-properites)                                                                                                                                 |
+| `coupon_lines`              | array   | List of cupon line items. See [Coupon Lines Properties](#coupon-lines-properties)                                                                                                                         |
+| `customer`                  | array   | Customer data. See [Customer Properties](#customers-properties)                                                                                                                                           |
+
+### Payment Details Properties ###
+
+|    Attribute     |   Type  |                                                               Description                                                                |
+| ---------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| `method_id`      | string  | Payment method ID <i class="label label-info">required</i>                                                                               |
+| `method_title`   | string  | Payment method title <i class="label label-info">required</i>                                                                            |
+| `paid`           | boolean | Shows/define if the order is paid using this payment method. Use `true` to complate the payment.                                         |
+| `transaction_id` | string  | Transaction ID, an optional field to set the transacion ID when complate one payment (to set this you need set the `paid` as `true` too) |
+
+### Line Items Properties ###
+
+|   Attribute    |   Type  |                                                                                         Description                                                                                         |
+| -------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `id`           | integer | Line item ID <i class="label label-info">read-only</i>                                                                                                                                      |
+| `subtotal`     | float   | Line item subtotal                                                                                                                                                                          |
+| `subtotal_tax` | float   | Line item tax subtotal                                                                                                                                                                      |
+| `total`        | float   | Line item total                                                                                                                                                                             |
+| `total_tax`    | float   | Line item tax total                                                                                                                                                                         |
+| `price`        | float   | Product price <i class="label label-info">read-only</i>                                                                                                                                     |
+| `quantity`     | integer | Quantity                                                                                                                                                                                    |
+| `tax_class`    | string  | Product tax class <i class="label label-info">read-only</i>                                                                                                                                 |
+| `name`         | string  | Product name <i class="label label-info">read-only</i>                                                                                                                                      |
+| `product_id`   | integer | Product ID <i class="label label-info">required</i>                                                                                                                                         |
+| `sku`          | string  | Product SKU <i class="label label-info">read-only</i>                                                                                                                                       |
+| `meta`         | array   | List of product meta items. See [Products Meta Items Properties](#products-meta-items-properties)                                                                                           |
+| `variations`   | array   | List of product variation attributes. e.g: `"variation": {"pa_color": "Black", "pa_size": "XGG"}` (Use `pa_` prefix when is a product attribute) <i class="label label-info">write-only</i> |
+
+#### Products Meta Items Properties ####
+
+| Attribute |  Type  |   Description   |
+| --------- | ------ | --------------- |
+| `key`     | string | Meta item key   |
+| `label`   | string | Meta item label |
+| `value`   | string | Meta item value |
+
+### Shipping Lines Properties ###
+
+|   Attribute    |   Type  |                          Description                           |
+| -------------- | ------- | -------------------------------------------------------------- |
+| `id`           | integer | Shipping line ID <i class="label label-info">read-only</i>     |
+| `method_id`    | string  | Shipping method ID <i class="label label-info">required</i>    |
+| `method_title` | string  | Shipping method title <i class="label label-info">required</i> |
+| `total`        | float   | Total amount                                                   |
+
+### Tax Lines Properties ###
+
+| Attribute  |   Type  |                                                               Description                                                               |
+| ---------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| `id`       | integer | Tax rate line ID <i class="label label-info">read-only</i>                                                                              |
+| `rate_id`  | integer | Tax rate ID <i class="label label-info">read-only</i>                                                                                   |
+| `code`     | string  | Tax rate code <i class="label label-info">read-only</i>                                                                                 |
+| `title`    | string  | Tax rate title/name <i class="label label-info">read-only</i>                                                                           |
+| `total`    | float   | Tax rate total <i class="label label-info">read-only</i>                                                                                |
+| `compound` | boolean | Shows if is or not a compound rate. Compound tax rates are applied on top of other tax rates. <i class="label label-info">read-only</i> |
+
+### Fee Lines Properites ###
+
+|  Attribute  |   Type  |                                  Description                                  |
+| ----------- | ------- | ----------------------------------------------------------------------------- |
+| `id`        | integer | Fee line ID <i class="label label-info">read-only</i>                         |
+| `title`     | string  | Shipping method title <i class="label label-info">required</i>                |
+| `taxable`   | boolean | Shows/define if the fee is taxable <i class="label label-info">write-only</i> |
+| `tax_class` | string  | Tax class, requered in write-mode if the fee is taxable                       |
+| `total`     | float   | Total amount                                                                  |
+| `total_tax` | float   | Tax total                                                                     |
+
+### Coupon Lines Properties ###
+
+| Attribute |   Type  |                       Description                        |
+| --------- | ------- | -------------------------------------------------------- |
+| `id`      | integer | Coupon line ID <i class="label label-info">read-only</i> |
+| `code`    | string  | Coupon code <i class="label label-info">required</i>     |
+| `amount`  | float   | Total amount <i class="label label-info">required</i>    |
+
+## Create An Order ##
+
+This API helps you to create a new order.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-post">POST</i>
+		<h6>/wc-api/v2/orders</h6>
+	</div>
+</div>
+
+> Example of create a paid order:
+
+```shell
+curl -X POST https://example.com/wc-api/v2/orders \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "order": {
+    "payment_details": {
+      "method_id": "bacs",
+      "method_title": "Direct Bank Transfer",
+      "paid": true
+    },
+    "billing_address": {
+      "first_name": "John",
+      "last_name": "Doe",
+      "address_1": "969 Market",
+      "address_2": "",
+      "city": "San Francisco",
+      "state": "CA",
+      "postcode": "94103",
+      "country": "US",
+      "email": "john.doe@example.com",
+      "phone": "(555) 555-5555"
+    },
+    "shipping_address": {
+      "first_name": "John",
+      "last_name": "Doe",
+      "address_1": "969 Market",
+      "address_2": "",
+      "city": "San Francisco",
+      "state": "CA",
+      "postcode": "94103",
+      "country": "US"
+    },
+    "customer_id": 2,
+    "line_items": [
+      {
+        "product_id": 546,
+        "quantity": 2
+      },
+      {
+        "product_id": 613,
+        "quantity": 1,
+        "variations": {
+          "pa_color": "Black"
+        }
+      }
+    ],
+    "shipping_lines": [
+      {
+        "method_id": "flat_rate",
+        "method_title": "Flat Rate",
+        "total": 10
+      }
+    ]
+  }
+}'
+```
+
+```javascript
+var data = {
+  order: {
+    payment_details: {
+      method_id: 'bacs',
+      method_title: 'Direct Bank Transfer',
+      paid: true
+    },
+    billing_address: {
+      first_name: 'John',
+      last_name: 'Doe',
+      address_1: '969 Market',
+      address_2: '',
+      city: 'San Francisco',
+      state: 'CA',
+      postcode: '94103',
+      country: 'US',
+      email: 'john.doe@example.com',
+      phone: '(555) 555-5555'
+    },
+    shipping_address: {
+      first_name: 'John',
+      last_name: 'Doe',
+      address_1: '969 Market',
+      address_2: '',
+      city: 'San Francisco',
+      state: 'CA',
+      postcode: '94103',
+      country: 'US'
+    },
+    customer_id: 2,
+    line_items: [
+      {
+        product_id: 546,
+        quantity: 2
+      },
+      {
+        product_id: 613,
+        quantity: 1,
+        variations: {
+          pa_color: 'Black'
+        }
+      }
+    ],
+    shipping_lines: [
+      {
+        method_id: 'flat_rate',
+        method_title: 'Flat Rate',
+        total: 10
+      }
+    ]
+  }
+};
+
+WooCommerce.post('orders', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "order": {
+        "payment_details": {
+            "method_id": "bacs",
+            "method_title": "Direct Bank Transfer",
+            "paid": True
+        },
+        "billing_address": {
+            "first_name": "John",
+            "last_name": "Doe",
+            "address_1": "969 Market",
+            "address_2": "",
+            "city": "San Francisco",
+            "state": "CA",
+            "postcode": "94103",
+            "country": "US",
+            "email": "john.doe@example.com",
+            "phone": "(555) 555-5555"
+        },
+        "shipping_address": {
+            "first_name": "John",
+            "last_name": "Doe",
+            "address_1": "969 Market",
+            "address_2": "",
+            "city": "San Francisco",
+            "state": "CA",
+            "postcode": "94103",
+            "country": "US"
+        },
+        "customer_id": 2,
+        "line_items": [
+            {
+                "product_id": 546,
+                "quantity": 2
+            },
+            {
+                "product_id": 613,
+                "quantity": 1,
+                "variations": {
+                    "pa_color": "Black"
+                }
+            }
+        ],
+        "shipping_lines": [
+            {
+                "method_id": "flat_rate",
+                "method_title": "Flat Rate",
+                "total": 10
+            }
+        ]
+    }
+}
+
+print(wcapi.post("orders", data).json())
+```
+
+```php
+<?php
+$data = array(
+    'order' => array(
+        'payment_details' => array(
+            'method_id' => 'bacs',
+            'method_title' => 'Direct Bank Transfer',
+            'paid' => true
+        ),
+        'billing_address' => array(
+            'first_name' => 'John',
+            'last_name' => 'Doe',
+            'address_1' => '969 Market',
+            'address_2' => '',
+            'city' => 'San Francisco',
+            'state' => 'CA',
+            'postcode' => '94103',
+            'country' => 'US',
+            'email' => 'john.doe@example.com',
+            'phone' => '(555) 555-5555'
+        ),
+        'shipping_address' => array(
+            'first_name' => 'John',
+            'last_name' => 'Doe',
+            'address_1' => '969 Market',
+            'address_2' => '',
+            'city' => 'San Francisco',
+            'state' => 'CA',
+            'postcode' => '94103',
+            'country' => 'US'
+        ),
+        'customer_id' => 2,
+        'line_items' => array(
+            array(
+                'product_id' => 546,
+                'quantity' => 2
+            ),
+            array(
+                'product_id' => 613,
+                'quantity' => 1,
+                'variations' => array(
+                    'pa_color' => 'Black'
+                )
+            )
+        ),
+        'shipping_lines' => array(
+            array(
+                'method_id' => 'flat_rate',
+                'method_title' => 'Flat Rate',
+                'total' => 10
+            )
+        )
+    )
+);
+
+print_r($woocommerce->orders->create($data));
+?>
+```
+
+```ruby
+data = {
+  order: {
+    payment_details: {
+      method_id: "bacs",
+      method_title: "Direct Bank Transfer",
+      paid: true
+    },
+    billing_address: {
+      first_name: "John",
+      last_name: "Doe",
+      address_1: "969 Market",
+      address_2: "",
+      city: "San Francisco",
+      state: "CA",
+      postcode: "94103",
+      country: "US",
+      email: "john.doe@example.com",
+      phone: "(555) 555-5555"
+    },
+    shipping_address: {
+      first_name: "John",
+      last_name: "Doe",
+      address_1: "969 Market",
+      address_2: "",
+      city: "San Francisco",
+      state: "CA",
+      postcode: "94103",
+      country: "US"
+    },
+    customer_id: 2,
+    line_items: [
+        {
+          product_id: 546,
+          quantity: 2
+        },
+        {
+          product_id: 613,
+          quantity: 1,
+          variations: {
+            pa_color: "Black"
+          }
+        }
+    ],
+    shipping_lines: [
+        {
+          method_id: "flat_rate",
+          method_title: "Flat Rate",
+          total: 10
+        }
+    ]
+  }
+}
+
+woocommerce.post("orders", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "order": {
+    "id": 645,
+    "order_number": 645,
+    "created_at": "2015-01-26T20:00:21Z",
+    "updated_at": "2015-01-26T20:00:21Z",
+    "completed_at": "2015-01-26T20:00:21Z",
+    "status": "processing",
+    "currency": "USD",
+    "total": "79.87",
+    "subtotal": "63.97",
+    "total_line_items_quantity": 3,
+    "total_tax": "5.90",
+    "total_shipping": "10.00",
+    "cart_tax": "5.40",
+    "shipping_tax": "0.50",
+    "total_discount": "0.00",
+    "shipping_methods": "Flat Rate",
+    "payment_details": {
+      "method_id": "bacs",
+      "method_title": "Direct Bank Transfer",
+      "paid": true
+    },
+    "billing_address": {
+      "first_name": "John",
+      "last_name": "Doe",
+      "company": "",
+      "address_1": "969 Market",
+      "address_2": "",
+      "city": "San Francisco",
+      "state": "CA",
+      "postcode": "94103",
+      "country": "US",
+      "email": "john.doe@example.com",
+      "phone": "(555) 555-5555"
+    },
+    "shipping_address": {
+      "first_name": "John",
+      "last_name": "Doe",
+      "company": "",
+      "address_1": "969 Market",
+      "address_2": "",
+      "city": "San Francisco",
+      "state": "CA",
+      "postcode": "94103",
+      "country": "US"
+    },
+    "note": "",
+    "customer_ip": "127.0.0.1",
+    "customer_user_agent": "WordPress/4.1; http://example.com",
+    "customer_id": 2,
+    "view_order_url": "https://example.com/my-account/view-order/645",
+    "line_items": [
+      {
+        "id": 504,
+        "subtotal": "43.98",
+        "subtotal_tax": "4.40",
+        "total": "43.98",
+        "total_tax": "4.40",
+        "price": "21.99",
+        "quantity": 2,
+        "tax_class": "reduced-rate",
+        "name": "Premium Quality",
+        "product_id": 546,
+        "sku": "",
+        "meta": []
+      },
+      {
+        "id": 505,
+        "subtotal": "19.99",
+        "subtotal_tax": "1.00",
+        "total": "19.99",
+        "total_tax": "1.00",
+        "price": "19.99",
+        "quantity": 1,
+        "tax_class": null,
+        "name": "Ship Your Idea",
+        "product_id": 613,
+        "sku": "",
+        "meta": [
+          {
+            "key": "pa_color",
+            "label": "Color",
+            "value": "Black"
+          }
+        ]
+      }
+    ],
+    "shipping_lines": [
+      {
+        "id": 506,
+        "method_id": "flat_rate",
+        "method_title": "Flat Rate",
+        "total": "10.00"
+      }
+    ],
+    "tax_lines": [
+      {
+        "id": 507,
+        "rate_id": "5",
+        "code": "US-CA-TAX-1",
+        "title": "Tax",
+        "total": "4.40",
+        "compound": false
+      },
+      {
+        "id": 508,
+        "rate_id": "4",
+        "code": "US-STANDARD-1",
+        "title": "Standard",
+        "total": "1.50",
+        "compound": false
+      }
+    ],
+    "fee_lines": [],
+    "coupon_lines": [],
+    "customer": {
+      "id": 2,
+      "created_at": "2014-11-19T18:34:19Z",
+      "email": "john.doe@example.com",
+      "first_name": "",
+      "last_name": "",
+      "username": "john.doe",
+      "last_order_id": "645",
+      "last_order_date": "2015-01-26T20:00:21Z",
+      "orders_count": 2,
+      "total_spent": "19.00",
+      "avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
+      "billing_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US",
+        "email": "john.doe@example.com",
+        "phone": "(555) 555-5555"
+      },
+      "shipping_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US"
+      }
+    }
+  }
+}
+```
+
+## View An Order ##
+
+This API lets you retrieve and view a specific order.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/orders/&lt;id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/orders/645 \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('orders/645', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("orders/645").json())
+```
+
+```php
+<?php print_r($woocommerce->orders->get(645)); ?>
+```
+
+```ruby
+woocommerce.get("orders/645").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "order": {
+    "id": 645,
+    "order_number": 645,
+    "created_at": "2015-01-26T20:00:21Z",
+    "updated_at": "2015-01-26T20:00:21Z",
+    "completed_at": "2015-01-26T20:00:21Z",
+    "status": "processing",
+    "currency": "USD",
+    "total": "79.87",
+    "subtotal": "63.97",
+    "total_line_items_quantity": 3,
+    "total_tax": "5.90",
+    "total_shipping": "10.00",
+    "cart_tax": "5.40",
+    "shipping_tax": "0.50",
+    "total_discount": "0.00",
+    "shipping_methods": "Flat Rate",
+    "payment_details": {
+      "method_id": "bacs",
+      "method_title": "Direct Bank Transfer",
+      "paid": true
+    },
+    "billing_address": {
+      "first_name": "John",
+      "last_name": "Doe",
+      "company": "",
+      "address_1": "969 Market",
+      "address_2": "",
+      "city": "San Francisco",
+      "state": "CA",
+      "postcode": "94103",
+      "country": "US",
+      "email": "john.doe@example.com",
+      "phone": "(555) 555-5555"
+    },
+    "shipping_address": {
+      "first_name": "John",
+      "last_name": "Doe",
+      "company": "",
+      "address_1": "969 Market",
+      "address_2": "",
+      "city": "San Francisco",
+      "state": "CA",
+      "postcode": "94103",
+      "country": "US"
+    },
+    "note": "",
+    "customer_ip": "127.0.0.1",
+    "customer_user_agent": "WordPress/4.1; http://example.com",
+    "customer_id": 2,
+    "view_order_url": "https://example.com/my-account/view-order/645",
+    "line_items": [
+      {
+        "id": 504,
+        "subtotal": "43.98",
+        "subtotal_tax": "4.40",
+        "total": "43.98",
+        "total_tax": "4.40",
+        "price": "21.99",
+        "quantity": 2,
+        "tax_class": "reduced-rate",
+        "name": "Premium Quality",
+        "product_id": 546,
+        "sku": "",
+        "meta": []
+      },
+      {
+        "id": 505,
+        "subtotal": "19.99",
+        "subtotal_tax": "1.00",
+        "total": "19.99",
+        "total_tax": "1.00",
+        "price": "19.99",
+        "quantity": 1,
+        "tax_class": null,
+        "name": "Ship Your Idea",
+        "product_id": 613,
+        "sku": "",
+        "meta": [
+          {
+            "key": "pa_color",
+            "label": "Color",
+            "value": "Black"
+          }
+        ]
+      }
+    ],
+    "shipping_lines": [
+      {
+        "id": 506,
+        "method_id": "flat_rate",
+        "method_title": "Flat Rate",
+        "total": "10.00"
+      }
+    ],
+    "tax_lines": [
+      {
+        "id": 507,
+        "rate_id": "5",
+        "code": "US-CA-TAX-1",
+        "title": "Tax",
+        "total": "4.40",
+        "compound": false
+      },
+      {
+        "id": 508,
+        "rate_id": "4",
+        "code": "US-STANDARD-1",
+        "title": "Standard",
+        "total": "1.50",
+        "compound": false
+      }
+    ],
+    "fee_lines": [],
+    "coupon_lines": [],
+    "customer": {
+      "id": 2,
+      "created_at": "2014-11-19T18:34:19Z",
+      "email": "john.doe@example.com",
+      "first_name": "",
+      "last_name": "",
+      "username": "john.doe",
+      "last_order_id": "645",
+      "last_order_date": "2015-01-26T20:00:21Z",
+      "orders_count": 2,
+      "total_spent": "19.00",
+      "avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
+      "billing_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US",
+        "email": "john.doe@example.com",
+        "phone": "(555) 555-5555"
+      },
+      "shipping_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US"
+      }
+    }
+  }
+}
+```
+
+## View List Of Orders ##
+
+This API helps you to view all the orders.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/orders</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/orders \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('orders', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("orders").json())
+```
+
+```php
+<?php print_r($woocommerce->orders->get()); ?>
+```
+
+```ruby
+woocommerce.get("orders").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "orders": [
+    {
+      "id": 645,
+      "order_number": 645,
+      "created_at": "2015-01-26T20:00:21Z",
+      "updated_at": "2015-01-26T20:00:21Z",
+      "completed_at": "2015-01-26T20:00:21Z",
+      "status": "processing",
+      "currency": "USD",
+      "total": "79.87",
+      "subtotal": "63.97",
+      "total_line_items_quantity": 3,
+      "total_tax": "5.90",
+      "total_shipping": "10.00",
+      "cart_tax": "5.40",
+      "shipping_tax": "0.50",
+      "total_discount": "0.00",
+      "shipping_methods": "Flat Rate",
+      "payment_details": {
+        "method_id": "bacs",
+        "method_title": "Direct Bank Transfer",
+        "paid": true
+      },
+      "billing_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US",
+        "email": "john.doe@example.com",
+        "phone": "(555) 555-5555"
+      },
+      "shipping_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US"
+      },
+      "note": "",
+      "customer_ip": "127.0.0.1",
+      "customer_user_agent": "WordPress/4.1; http://example.com",
+      "customer_id": 2,
+      "view_order_url": "https://example.com/my-account/view-order/645",
+      "line_items": [
+        {
+          "id": 504,
+          "subtotal": "43.98",
+          "subtotal_tax": "4.40",
+          "total": "43.98",
+          "total_tax": "4.40",
+          "price": "21.99",
+          "quantity": 2,
+          "tax_class": "reduced-rate",
+          "name": "Premium Quality",
+          "product_id": 546,
+          "sku": "",
+          "meta": []
+        },
+        {
+          "id": 505,
+          "subtotal": "19.99",
+          "subtotal_tax": "1.00",
+          "total": "19.99",
+          "total_tax": "1.00",
+          "price": "19.99",
+          "quantity": 1,
+          "tax_class": null,
+          "name": "Ship Your Idea",
+          "product_id": 613,
+          "sku": "",
+          "meta": [
+            {
+              "key": "pa_color",
+              "label": "Color",
+              "value": "Black"
+            }
+          ]
+        }
+      ],
+      "shipping_lines": [
+        {
+          "id": 506,
+          "method_id": "flat_rate",
+          "method_title": "Flat Rate",
+          "total": "10.00"
+        }
+      ],
+      "tax_lines": [
+        {
+          "id": 507,
+          "rate_id": "5",
+          "code": "US-CA-TAX-1",
+          "title": "Tax",
+          "total": "4.40",
+          "compound": false
+        },
+        {
+          "id": 508,
+          "rate_id": "4",
+          "code": "US-STANDARD-1",
+          "title": "Standard",
+          "total": "1.50",
+          "compound": false
+        }
+      ],
+      "fee_lines": [],
+      "coupon_lines": [],
+      "customer": {
+        "id": 2,
+        "created_at": "2014-11-19T18:34:19Z",
+        "email": "john.doe@example.com",
+        "first_name": "",
+        "last_name": "",
+        "username": "john.doe",
+        "last_order_id": "645",
+        "last_order_date": "2015-01-26T20:00:21Z",
+        "orders_count": 2,
+        "total_spent": "19.00",
+        "avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
+        "billing_address": {
+          "first_name": "John",
+          "last_name": "Doe",
+          "company": "",
+          "address_1": "969 Market",
+          "address_2": "",
+          "city": "San Francisco",
+          "state": "CA",
+          "postcode": "94103",
+          "country": "US",
+          "email": "john.doe@example.com",
+          "phone": "(555) 555-5555"
+        },
+        "shipping_address": {
+          "first_name": "John",
+          "last_name": "Doe",
+          "company": "",
+          "address_1": "969 Market",
+          "address_2": "",
+          "city": "San Francisco",
+          "state": "CA",
+          "postcode": "94103",
+          "country": "US"
+        }
+      }
+    },
+    {
+      "id": 644,
+      "order_number": 644,
+      "created_at": "2015-01-26T19:33:42Z",
+      "updated_at": "2015-01-26T19:33:42Z",
+      "completed_at": "2015-01-26T19:33:42Z",
+      "status": "on-hold",
+      "currency": "USD",
+      "total": "44.14",
+      "subtotal": "30.99",
+      "total_line_items_quantity": 2,
+      "total_tax": "3.15",
+      "total_shipping": "10.00",
+      "cart_tax": "2.65",
+      "shipping_tax": "0.50",
+      "total_discount": "0.00",
+      "shipping_methods": "Flat Rate",
+      "payment_details": {
+        "method_id": "bacs",
+        "method_title": "Direct Bank Transfer",
+        "paid": false
+      },
+      "billing_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US",
+        "email": "john.doe@example.com",
+        "phone": "(555) 555-5555"
+      },
+      "shipping_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US"
+      },
+      "note": "",
+      "customer_ip": "127.0.0.1",
+      "customer_user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/40.0.2214.91 Safari/537.36",
+      "customer_id": 2,
+      "view_order_url": "https://example.com/my-account/view-order/644",
+      "line_items": [
+        {
+          "id": 499,
+          "subtotal": "21.99",
+          "subtotal_tax": "2.20",
+          "total": "21.99",
+          "total_tax": "2.20",
+          "price": "21.99",
+          "quantity": 1,
+          "tax_class": "reduced-rate",
+          "name": "Premium Quality",
+          "product_id": 546,
+          "sku": "",
+          "meta": []
+        },
+        {
+          "id": 500,
+          "subtotal": "9.00",
+          "subtotal_tax": "0.45",
+          "total": "9.00",
+          "total_tax": "0.45",
+          "price": "9.00",
+          "quantity": 1,
+          "tax_class": null,
+          "name": "Woo Album #4",
+          "product_id": 96,
+          "sku": "",
+          "meta": []
+        }
+      ],
+      "shipping_lines": [
+        {
+          "id": 501,
+          "method_id": "flat_rate",
+          "method_title": "Flat Rate",
+          "total": "10.00"
+        }
+      ],
+      "tax_lines": [
+        {
+          "id": 502,
+          "rate_id": "5",
+          "code": "US-CA-TAX-1",
+          "title": "Tax",
+          "total": "4.40",
+          "compound": false
+        },
+        {
+          "id": 503,
+          "rate_id": "4",
+          "code": "US-STANDARD-1",
+          "title": "Standard",
+          "total": "1.50",
+          "compound": false
+        }
+      ],
+      "fee_lines": [],
+      "coupon_lines": [],
+      "customer": {
+        "id": 2,
+        "created_at": "2014-11-19T18:34:19Z",
+        "email": "john.doe@example.com",
+        "first_name": "",
+        "last_name": "",
+        "username": "john.doe",
+        "last_order_id": "645",
+        "last_order_date": "2015-01-26T20:00:21Z",
+        "orders_count": 2,
+        "total_spent": "19.00",
+        "avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
+        "billing_address": {
+          "first_name": "John",
+          "last_name": "Doe",
+          "company": "",
+          "address_1": "969 Market",
+          "address_2": "",
+          "city": "San Francisco",
+          "state": "CA",
+          "postcode": "94103",
+          "country": "US",
+          "email": "john.doe@example.com",
+          "phone": "(555) 555-5555"
+        },
+        "shipping_address": {
+          "first_name": "John",
+          "last_name": "Doe",
+          "company": "",
+          "address_1": "969 Market",
+          "address_2": "",
+          "city": "San Francisco",
+          "state": "CA",
+          "postcode": "94103",
+          "country": "US"
+        }
+      }
+    }
+  ]
+}
+```
+
+#### Available Filters ####
+
+|  Filter  |  Type  |                    Description                    |
+| -------- | ------ | ------------------------------------------------- |
+| `status` | string | Orders by status. eg: `processing` or `cancelled` |
+
+## Update An Order ##
+
+This API lets you make changes to an order.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-put">PUT</i>
+		<h6>/wc-api/v2/orders/&lt;id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl -X PUT https://example.com/wc-api/v2/orders/645 \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "order": {
+    "status": "completed"
+  }
+}'
+```
+
+```javascript
+var data = {
+  order: {
+    status: 'completed'
+  }
+};
+
+WooCommerce.put('orders/645', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "order": {
+        "status": "completed"
+    }
+}
+
+print(wcapi.put("orders/645", data).json())
+```
+
+```php
+<?php
+$data = array(
+    'order' => array(
+        'status' => 'completed'
+    )
+);
+
+print_r($woocommerce->orders->update(645, $data));
+?>
+```
+
+```ruby
+data = {
+  order: {
+    status: "completed"
+  }
+}
+
+woocommerce.put("orders/645", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "order": {
+    "id": 645,
+    "order_number": 645,
+    "created_at": "2015-01-26T20:00:21Z",
+    "updated_at": "2015-01-26T20:00:21Z",
+    "completed_at": "2015-01-26T20:00:21Z",
+    "status": "completed",
+    "currency": "USD",
+    "total": "79.87",
+    "subtotal": "63.97",
+    "total_line_items_quantity": 3,
+    "total_tax": "5.90",
+    "total_shipping": "10.00",
+    "cart_tax": "5.40",
+    "shipping_tax": "0.50",
+    "total_discount": "0.00",
+    "shipping_methods": "Flat Rate",
+    "payment_details": {
+      "method_id": "bacs",
+      "method_title": "Direct Bank Transfer",
+      "paid": true
+    },
+    "billing_address": {
+      "first_name": "John",
+      "last_name": "Doe",
+      "company": "",
+      "address_1": "969 Market",
+      "address_2": "",
+      "city": "San Francisco",
+      "state": "CA",
+      "postcode": "94103",
+      "country": "US",
+      "email": "john.doe@example.com",
+      "phone": "(555) 555-5555"
+    },
+    "shipping_address": {
+      "first_name": "John",
+      "last_name": "Doe",
+      "company": "",
+      "address_1": "969 Market",
+      "address_2": "",
+      "city": "San Francisco",
+      "state": "CA",
+      "postcode": "94103",
+      "country": "US"
+    },
+    "note": "",
+    "customer_ip": "127.0.0.1",
+    "customer_user_agent": "WordPress/4.1; http://example.com",
+    "customer_id": 2,
+    "view_order_url": "https://example.com/my-account/view-order/645",
+    "line_items": [
+      {
+        "id": 504,
+        "subtotal": "43.98",
+        "subtotal_tax": "4.40",
+        "total": "43.98",
+        "total_tax": "4.40",
+        "price": "21.99",
+        "quantity": 2,
+        "tax_class": "reduced-rate",
+        "name": "Premium Quality",
+        "product_id": 546,
+        "sku": "",
+        "meta": []
+      },
+      {
+        "id": 505,
+        "subtotal": "19.99",
+        "subtotal_tax": "1.00",
+        "total": "19.99",
+        "total_tax": "1.00",
+        "price": "19.99",
+        "quantity": 1,
+        "tax_class": null,
+        "name": "Ship Your Idea",
+        "product_id": 613,
+        "sku": "",
+        "meta": [
+          {
+            "key": "pa_color",
+            "label": "Color",
+            "value": "Black"
+          }
+        ]
+      }
+    ],
+    "shipping_lines": [
+      {
+        "id": 506,
+        "method_id": "flat_rate",
+        "method_title": "Flat Rate",
+        "total": "10.00"
+      }
+    ],
+    "tax_lines": [
+      {
+        "id": 507,
+        "rate_id": "5",
+        "code": "US-CA-TAX-1",
+        "title": "Tax",
+        "total": "4.40",
+        "compound": false
+      },
+      {
+        "id": 508,
+        "rate_id": "4",
+        "code": "US-STANDARD-1",
+        "title": "Standard",
+        "total": "1.50",
+        "compound": false
+      }
+    ],
+    "fee_lines": [],
+    "coupon_lines": [],
+    "customer": {
+      "id": 2,
+      "created_at": "2014-11-19T18:34:19Z",
+      "email": "john.doe@example.com",
+      "first_name": "",
+      "last_name": "",
+      "username": "john.doe",
+      "last_order_id": "645",
+      "last_order_date": "2015-01-26T20:00:21Z",
+      "orders_count": 2,
+      "total_spent": "19.00",
+      "avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
+      "billing_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US",
+        "email": "john.doe@example.com",
+        "phone": "(555) 555-5555"
+      },
+      "shipping_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US"
+      }
+    }
+  }
+}
+```
+
+## Delete An Order ##
+
+This API helps you delete an order.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-delete">DELETE</i>
+		<h6>/wc-api/v2/orders/&lt;id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl -X DELETE https://example.com/wc-api/v2/orders/645/?force=true \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.delete('orders/645/?force=true', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.delete("orders/645/?force=true").json())
+```
+
+```php
+<?php print_r($woocommerce->orders->delete(645, true)); ?>
+```
+
+```ruby
+woocommerce.delete("orders/645/?force=true").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "message": "Permanently deleted order"
+}
+```
+
+### Parameters ###
+
+| Parameter |  Type  |                                                                         Description                                                                          |
+| --------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `force`   | string | Use `true` whether to permanently delete the order, defaults to `false`. Note that permanently deleting the order will return HTTP 200 rather than HTTP 202. |
+
+## View Orders Count ##
+
+This API lets you retrieve a count of all orders.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/orders/count</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/orders/count \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('orders/count', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("orders/count").json())
+```
+
+```php
+<?php print_r($woocommerce->orders->get_count()); ?>
+```
+
+```ruby
+woocommerce.get("orders/count").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "count": 2
+}
+```
+
+#### Available Filters ####
+
+|  Filter  |  Type  |                    Description                    |
+| -------- | ------ | ------------------------------------------------- |
+| `status` | string | Orders by status. eg: `processing` or `cancelled` |
+
+## View List Of Order Statuses ##
+
+This API lets you retrieve a list of orders statuses available.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/orders/statuses</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/orders/statuses \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('orders/statuses', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("orders/statuses").json())
+```
+
+```php
+<?php print_r($woocommerce->orders->get_statuses()); ?>
+```
+
+```ruby
+woocommerce.get("orders/statuses").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "order_statuses": {
+    "pending": "Pending Payment",
+    "processing": "Processing",
+    "on-hold": "On Hold",
+    "completed": "Completed",
+    "cancelled": "Cancelled",
+    "refunded": "Refunded",
+    "failed": "Failed"
+  }
+}
+```
+
+## Create A Note For An Order ##
+
+This API helps you to create a new note for an order.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-post">POST</i>
+		<h6>/wc-api/v2/orders/&lt;id&gt;/notes</h6>
+	</div>
+</div>
+
+```shell
+curl -X POST https://example.com/wc-api/v2/orders/645/notes \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "order_note": {
+    "note": "Order ok!!!"
+  }
+}'
+```
+
+```javascript
+var data = {
+  order_note: {
+    note: 'Order ok!!!'
+  }
+};
+
+WooCommerce.post('orders/645/notes', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "order_note": {
+        "note": "Order ok!!!"
+    }
+}
+
+print(wcapi.post("orders/645/notes", data).json())
+```
+
+```php
+<?php
+$data = array(
+    'order_note' => array(
+        'note' => 'Order ok!!!'
+    )
+);
+
+print_r($woocommerce->order_notes->create(645, $data));
+?>
+```
+
+```ruby
+data = {
+  order_note: {
+    note: "Order ok!!!"
+  }
+}
+
+woocommerce.post("orders/645/notes", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "order_note": {
+    "id": "416",
+    "created_at": "2015-01-26T20:56:44Z",
+    "note": "Order ok!!!",
+    "customer_note": false
+  }
+}
+```
+
+### Order Notes Properties ###
+
+|    Attribute    |   Type  |                                                    Description                                                     |
+| --------------- | ------- | ------------------------------------------------------------------------------------------------------------------ |
+| `id`            | integer | Order note ID <i class="label label-info">read-only</i>                                                            |
+| `created_at`    | string  | UTC DateTime when the order note was created <i class="label label-info">read-only</i>                             |
+| `note`          | string  | Order note <i class="label label-info">required</i>                                                                |
+| `customer_note` | boolean | Shows/define if the note is only for reference or for the customer (the user will be notified). Default is `false` |
+
+## View An Order Note ##
+
+This API lets you retrieve and view a specific note from an order.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/orders/&lt;id&gt;/notes/&lt;note_id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/orders/645/notes/416 \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('orders/645/notes/416', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("orders/645/notes/416").json())
+```
+
+```php
+<?php print_r($woocommerce->order_notes->get(645, 416)); ?>
+```
+
+```ruby
+woocommerce.get("orders/645/notes/416").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "order_note": {
+    "id": "416",
+    "created_at": "2015-01-26T20:56:44Z",
+    "note": "Order ok!!!",
+    "customer_note": false
+  }
+}
+```
+
+<aside class="notice">
+	View the <a href="#order-notes-properties">Order Notes Properties</a> for more details on this response.
+</aside>
+
+## View List Of Notes From An Order ##
+
+This API helps you to view all the notes from an order.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/orders/&lt;id&gt;/notes</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/orders/645/notes \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('orders/645/notes', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("orders/645/notes").json())
+```
+
+```php
+<?php print_r($woocommerce->order_notes->get(645)); ?>
+```
+
+```ruby
+woocommerce.get("orders/645/notes").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "order_notes": [
+    {
+      "id": "416",
+      "created_at": "2015-01-26T20:56:44Z",
+      "note": "Order ok!!!",
+      "customer_note": false
+    },
+    {
+      "id": "415",
+      "created_at": "2015-01-26T20:16:14Z",
+      "note": "Order status changed from Processing to Completed.",
+      "customer_note": false
+    },
+    {
+      "id": "412",
+      "created_at": "2015-01-26T20:00:21Z",
+      "note": "Order item stock reduced successfully.",
+      "customer_note": false
+    },
+    {
+      "id": "411",
+      "created_at": "2015-01-26T20:00:09Z",
+      "note": "Order status changed from Pending Payment to Processing.",
+      "customer_note": false
+    }
+  ]
+}
+```
+
+<aside class="notice">
+	View the <a href="#order-notes-properties">Order Notes Properties</a> for more details on this response.
+</aside>
+
+## Update An Order Note ##
+
+This API lets you make changes to an order note.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-put">PUT</i>
+		<h6>/wc-api/v2/orders/&lt;id&gt;/notes/&lt;note_id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl -X PUT https://example.com/wc-api/v2/orders/645/notes/416 \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "order_note": {
+    "note": "Ok!"
+  }
+}'
+```
+
+```javascript
+var data = {
+  order_note: {
+    note: 'Ok!'
+  }
+};
+
+WooCommerce.put('orders/645/notes/416', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "order_note": {
+        "note": "Ok!"
+    }
+}
+
+print(wcapi.put("orders/645/notes/416", data).json())
+```
+
+```php
+<?php
+$data = array(
+    'order_note' => array(
+        'note' => 'Ok!'
+    )
+);
+
+print_r($woocommerce->order_notes->update(645, 416, $data));
+?>
+```
+
+```ruby
+data = {
+  order_note: {
+    note: "Ok!"
+  }
+}
+
+woocommerce.put("orders/645/notes/416", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "order_note": {
+    "id": "416",
+    "created_at": "2015-01-26T20:56:44Z",
+    "note": "Ok!",
+    "customer_note": false
+  }
+}
+```
+
+<aside class="notice">
+	View the <a href="#order-notes-properties">Order Notes Properties</a> for more details on this response.
+</aside>
+
+## Delete An Order Note ##
+
+This API helps you delete an order note.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-delete">DELETE</i>
+		<h6>/wc-api/v2/orders/&lt;id&gt;/notes/&lt;note_id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl -X DELETE https://example.com/wc-api/v2/orders/645/notes/416 \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.delete('orders/645/notes/416', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.delete("orders/645/notes/416").json())
+```
+
+```php
+<?php print_r($woocommerce->order_notes->delete(645, 416)); ?>
+```
+
+```ruby
+woocommerce.delete("orders/645/notes/416").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "message": "Permanently deleted order note"
+}
+```
+
+## Create A Refund For An Order ##
+
+This API helps you to create a new refund for an order.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-post">POST</i>
+		<h6>/wc-api/v2/orders/&lt;id&gt;/refunds</h6>
+	</div>
+</div>
+
+```shell
+curl -X POST https://example.com/wc-api/v2/orders/645/refunds \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "order_refund": {
+    "amount": 10
+  }
+}'
+```
+
+```javascript
+var data = {
+  order_refund: {
+    amount: 10
+  }
+};
+
+WooCommerce.post('orders/645/refunds', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "order_refund": {
+        "amount": 10
+    }
+}
+
+print(wcapi.post("orders/645/refunds", data).json())
+```
+
+```php
+<?php
+$data = array(
+    'order_refund' => array(
+        'amount' => 10
+    )
+);
+
+print_r($woocommerce->order_refunds->create(645, $data));
+?>
+```
+
+```ruby
+data = {
+  order_refund: {
+    amount: 10
+  }
+}
+
+woocommerce.post("orders/645/refunds", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "order_refund": {
+    "id": 649,
+    "created_at": "2015-01-26T19:29:32Z",
+    "amount": "10.00",
+    "reason": "",
+    "line_items": []
+  }
+}
+```
+
+### Order Refunds Properties ###
+
+|  Attribute   |   Type  |                                       Description                                        |
+| ------------ | ------- | ---------------------------------------------------------------------------------------- |
+| `id`         | integer | Order note ID <i class="label label-info">read-only</i>                                  |
+| `created_at` | string  | UTC DateTime when the order refund was created <i class="label label-info">read-only</i> |
+| `amount`     | float   | Refund amount <i class="label label-info">required</i>                                   |
+| `reason`     | string  | Reason for refund                                                                        |
+| `line_items` | array   | List of order items to refund. See [Line Items Properties](line-items-properties)        |
+
+## View An Order Refund ##
+
+This API lets you retrieve and view a specific refund from an order.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/orders/&lt;id&gt;/refunds/&lt;refund_id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/orders/645/refunds/649 \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('orders/645/refunds/649', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("orders/645/refunds/649").json())
+```
+
+```php
+<?php print_r($woocommerce->order_refunds->get(645, 649)); ?>
+```
+
+```ruby
+woocommerce.get("orders/645/refunds/649").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "order_refund": {
+    "id": 649,
+    "created_at": "2015-01-26T19:29:32Z",
+    "amount": "10.00",
+    "reason": "",
+    "line_items": []
+  }
+}
+```
+
+<aside class="notice">
+	View the <a href="#order-refunds-properties">Order Refunds Properties</a> for more details on this response.
+</aside>
+
+## View List Of Refunds From An Order ##
+
+This API helps you to view all the refunds from an order.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/orders/&lt;id&gt;/refunds</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/orders/645/refunds \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('orders/645/refunds', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("orders/645/refunds").json())
+```
+
+```php
+<?php print_r($woocommerce->order_refunds->get(645)); ?>
+```
+
+```ruby
+woocommerce.get("orders/645/refunds").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "order_refunds": [
+    {
+      "id": 649,
+      "created_at": "2015-01-26T19:29:32Z",
+      "amount": "10.00",
+      "reason": "",
+      "line_items": []
+    },
+    {
+      "id": 647,
+      "created_at": "2015-01-26T19:19:06Z",
+      "amount": "21.99",
+      "reason": "",
+      "line_items": [
+        {
+          "id": 514,
+          "subtotal": "-21.99",
+          "subtotal_tax": "0.00",
+          "total": "-21.99",
+          "total_tax": "0.00",
+          "price": "-21.99",
+          "quantity": 1,
+          "tax_class": "reduced-rate",
+          "name": "Premium Quality",
+          "product_id": 546,
+          "sku": "",
+          "meta": []
+        },
+        {
+          "id": 515,
+          "subtotal": "0.00",
+          "subtotal_tax": "0.00",
+          "total": "0.00",
+          "total_tax": "0.00",
+          "price": "0.00",
+          "quantity": 0,
+          "tax_class": null,
+          "name": "Ship Your Idea",
+          "product_id": 613,
+          "sku": "",
+          "meta": []
+        }
+      ]
+    }
+  ]
+}
+```
+
+<aside class="notice">
+	View the <a href="#order-refunds-properties">Order Refunds Properties</a> for more details on this response.
+</aside>
+
+## Update An Order Refund ##
+
+This API lets you make changes to an order refund.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-put">PUT</i>
+		<h6>/wc-api/v2/orders/&lt;id&gt;/refunds/&lt;refund_id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl -X PUT https://example.com/wc-api/v2/orders/645/refunds/649 \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "order_refund": {
+    "reason": "Because was it necessary!"
+  }
+}'
+```
+
+```javascript
+var data = {
+  order_refund: {
+    reason: 'Because was it necessary!'
+  }
+};
+
+WooCommerce.put('orders/645/refunds/649', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "order_refund": {
+        "reason": "Because was it necessary!"
+    }
+}
+
+print(wcapi.put("orders/645/refunds/649", data).json())
+```
+
+```php
+<?php
+$data = array(
+    'order_refund' => array(
+        'reason' => 'Because was it necessary!'
+    )
+);
+
+print_r($woocommerce->order_refunds->update(645, 649, $data));
+?>
+```
+
+```ruby
+data = {
+  order_refund: {
+    reason: "Because was it necessary!"
+  }
+}
+
+woocommerce.put("orders/645/refunds/649", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "order_refund": {
+    "id": 649,
+    "created_at": "2015-01-26T19:29:32Z",
+    "amount": "10.00",
+    "reason": "Because was it necessary!",
+    "line_items": []
+  }
+}
+```
+
+<aside class="notice">
+	View the <a href="#order-refunds-properties">Order Refunds Properties</a> for more details on this response.
+</aside>
+
+## Delete An Order Refund ##
+
+This API helps you delete an order refund.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-delete">DELETE</i>
+		<h6>/wc-api/v2/orders/&lt;id&gt;/refunds/&lt;refund_id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl -X DELETE https://example.com/wc-api/v2/orders/645/refunds/649 \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.delete('orders/645/refunds/649', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.delete("orders/645/refunds/649").json())
+```
+
+```php
+<?php print_r($woocommerce->order_refunds->delete(645, 649)); ?>
+```
+
+```ruby
+woocommerce.delete("orders/645/refunds/649").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "message": "Permanently deleted refund"
+}
+```
diff --git a/source/includes/v3/_products.md b/source/includes/v3/_products.md
new file mode 100644
index 00000000..8677c882
--- /dev/null
+++ b/source/includes/v3/_products.md
@@ -0,0 +1,2106 @@
+# Products #
+
+This section lists all API that can be used to create, edit or otherwise manipulate products.
+
+## Products Properties ##
+
+|            Attribute            |   Type  |                                                                                                                           Description                                                                                                                            |
+| ------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `title`                         | string  | Product name                                                                                                                                                                                                                                                     |
+| `id`                            | integer | Product ID (post ID) <i class="label label-info">read-only</i>                                                                                                                                                                                                   |
+| `created_at`                    | string  | UTC DateTime when the product was created <i class="label label-info">read-only</i>                                                                                                                                                                              |
+| `updated_at`                    | string  | UTC DateTime when the product was last updated <i class="label label-info">read-only</i>                                                                                                                                                                         |
+| `type`                          | string  | Product type. By default in WooCommerce the following types are available: `simple`, `grouped`, `external`, `variable`. Default is `simple`                                                                                                                      |
+| `status`                        | string  | Product status (post status). Default is `publish`                                                                                                                                                                                                               |
+| `downloadable`                  | boolean | If the product is downloadable or not. Downloadable products give access to a file upon purchase                                                                                                                                                                 |
+| `virtual`                       | boolean | If the product is virtual or not. Virtual products are intangible and aren't shipped                                                                                                                                                                             |
+| `permalink`                     | string  | Product URL (post permalink) <i class="label label-info">read-only</i>                                                                                                                                                                                           |
+| `sku`                           | string  | SKU refers to a Stock-keeping unit, a unique identifier for each distinct product and service that can be purchased                                                                                                                                              |
+| `price`                         | float   | Current product price. This is setted from `regular_price` and `sale_price` <i class="label label-info">read-only</i>                                                                                                                                            |
+| `regular_price`                 | float   | Product regular price                                                                                                                                                                                                                                            |
+| `sale_price`                    | float   | Product sale price                                                                                                                                                                                                                                               |
+| `sale_price_dates_from`         | float   | Sets the sale start date. Date in the `YYYY-MM-DD` format <i class="label label-info">write-only</i>                                                                                                                                                             |
+| `sale_price_dates_to`           | float   | Sets the sale end date. Date in the `YYYY-MM-DD` format <i class="label label-info">write-only</i>                                                                                                                                                               |
+| `price_html`                    | string  | Price formatted in HTML, e.g. `<del><span class=\"amount\">&#36;&nbsp;3.00</span></del> <ins><span class=\"amount\">&#36;&nbsp;2.00</span></ins>` <i class="label label-info">read-only</i>                                                                      |
+| `taxable`                       | boolean | Show if the product is taxable or not <i class="label label-info">read-only</i>                                                                                                                                                                                  |
+| `tax_status`                    | string  | Tax status. The options are: `taxable`, `shipping` (Shipping only) and `none`                                                                                                                                                                                    |
+| `tax_class`                     | string  | Tax class                                                                                                                                                                                                                                                        |
+| `managing_stock`                | boolean | Enable stock management at product level                                                                                                                                                                                                                         |
+| `stock_quantity`                | integer | Stock quantity. If is a variable product this value will be used to control stock for all variations, unless you define stock at variation level.                                                                                                                |
+| `in_stock`                      | boolean | Controls whether or not the product is listed as "in stock" or "out of stock" on the frontend.                                                                                                                                                                   |
+| `backorders_allowed`            | boolean | Shows if backorders are allowed <i class="label label-info">read-only</i>                                                                                                                                                                                        |
+| `backordered`                   | boolean | Shows if a product is on backorder (if the product have the stock_quantity negative) <i class="label label-info">read-only</i>                                                                                                                                   |
+| `backorders`                    | mixed   | If managing stock, this controls whether or not backorders are allowed. If enabled, stock quantity can go below 0. The options are: `false` (Do not allow), `notify` (Allow, but notify customer), and `true` (Allow) <i class="label label-info">write-only</i> |
+| `sold_individually`             | boolean | When `true` this only allow one item to be bought in a single order                                                                                                                                                                                              |
+| `purchaseable`                  | boolean | Shows if the product can be bought <i class="label label-info">read-only</i>                                                                                                                                                                                     |
+| `featured`                      | boolean | Featured Product                                                                                                                                                                                                                                                 |
+| `visible`                       | boolean | Shows whether or not the product is visible in the catalog <i class="label label-info">read-only</i>                                                                                                                                                             |
+| `catalog_visibility`            | string  | Catalog visibility. The following options are available: `visible` (Catalog and search), `catalog` (Only in catalog), `search` (Only in search) and `hidden` (Hidden from all). Default is `visible`                                                             |
+| `on_sale`                       | boolean | Shows if the product is on sale or not <i class="label label-info">read-only</i>                                                                                                                                                                                 |
+| `weight`                        | string  | Product weight in decimal format                                                                                                                                                                                                                                 |
+| `dimensions`                    | array   | List of the product dimensions. See [Dimensions Properties](#dimensions-properties)                                                                                                                                                                              |
+| `shipping_required`             | boolean | Shows if the product need to be shipped or not <i class="label label-info">read-only</i>                                                                                                                                                                         |
+| `shipping_taxable`              | boolean | Shows whether or not the product shipping is taxable <i class="label label-info">read-only</i>                                                                                                                                                                   |
+| `shipping_class`                | string  | Shipping class slug. Shipping classes are used by certain shipping methods to group similar products                                                                                                                                                             |
+| `shipping_class_id`             | integer | Shipping class ID <i class="label label-info">read-only</i>                                                                                                                                                                                                      |
+| `description`                   | string  | Product description                                                                                                                                                                                                                                              |
+| `enable_html_description`       | bool    | Enable HTML for product description <i class="label label-info">write-only</i>                                                                                                                                                                                   |
+| `short_description`             | string  | Product short description                                                                                                                                                                                                                                        |
+| `enable_html_short_description` | string  | Enable HTML for product short description <i class="label label-info">write-only</i>                                                                                                                                                                             |
+| `reviews_allowed`               | boolean | Shows/define if reviews are allowed                                                                                                                                                                                                                              |
+| `average_rating`                | string  | Reviews average rating <i class="label label-info">read-only</i>                                                                                                                                                                                                 |
+| `rating_count`                  | integer | Amount of reviews that the product have <i class="label label-info">read-only</i>                                                                                                                                                                                |
+| `related_ids`                   | array   | List of related products IDs (`integer`) <i class="label label-info">read-only</i>                                                                                                                                                                               |
+| `upsell_ids`                    | array   | List of up-sell products IDs (`integer`). Up-sells are products which you recommend instead of the currently viewed product, for example, products that are more profitable or better quality or more expensive                                                  |
+| `cross_sell_ids`                | array   | List of cross-sell products IDs. Cross-sells are products which you promote in the cart, based on the current product                                                                                                                                            |
+| `parent_id`                     | integer | Product parent ID (post_parent)                                                                                                                                                                                                                                  |
+| `categories`                    | array   | List of product categories names (`string`). In write-mode need to pass a array of categories IDs (`integer`) ([uses wp_set_object_terms()](http://codex.wordpress.org/Function_Reference/wp_set_object_terms))                                                  |
+| `tags`                          | array   | List of product tags names (`string`). In write-mode need to pass a array of tags IDs (`integer`) ([uses wp_set_object_terms()](http://codex.wordpress.org/Function_Reference/wp_set_object_terms))                                                              |
+| `images`                        | array   | List of products images. See [Images Properties](#images-properties)                                                                                                                                                                                             |
+| `featured_src`                  | string  | Featured image URL <i class="label label-info">read-only</i>                                                                                                                                                                                                     |
+| `attributes`                    | array   | List of product attributes. See [Attributes Properties](#attributes-properties). Note: the attribute must be registered in WooCommerce before.                                                                                                                   |
+| `default_attributes`            | array   | Defaults variation attributes. These are the attributes that will be pre-selected on the frontend. See [Default Attributes Properties](#default-attributes-properties) <i class="label label-info">write-only</i>                                                |
+| `downloads`                     | array   | List of downloadable files. See [Downloads Properties](#downloads-properties)                                                                                                                                                                                    |
+| `download_limit`                | integer | Amount of times the product can be downloaded. In write-mode you can sent a blank string for unlimited re-downloads. e.g `''`                                                                                                                                    |
+| `download_expiry`               | integer | Number of days that the customer has up to be able to download the product. In write-mode you can sent a blank string for never expiry. e.g `''`                                                                                                                 |
+| `download_type`                 | string  | Download type, this controls the [schema](http://schema.org/). The available options are: `''` (Standard Product), `application` (Application/Software) and `music` (Music)                                                                                      |
+| `purchase_note`                 | string  | Optional note to send the customer after purchase.                                                                                                                                                                                                               |
+| `total_sales`                   | integer | Amount of sales <i class="label label-info">read-only</i>                                                                                                                                                                                                        |
+| `variations`                    | array   | List of products variations. See [Variations Properties](#variations-properties)                                                                                                                                                                                 |
+| `parent`                        | array   | List the product parent data when query for a variation <i class="label label-info">read-only</i>                                                                                                                                                                |
+| `product_url`                   | string  | Product external URL. Only for `external` products <i class="label label-info">write-only</i>                                                                                                                                                                    |
+| `button_text`                   | string  | Product external button text. Only for `external` products <i class="label label-info">write-only</i>                                                                                                                                                            |
+
+### Dimensions Properties ###
+
+| Attribute |  Type  |                      Description                       |
+| --------- | ------ | ------------------------------------------------------ |
+| `length`  | string | Product length in decimal format                       |
+| `width`   | string | Product width in decimal format                        |
+| `height`  | string | Product height in decimal format                       |
+| `unit`    | string | Product name <i class="label label-info">read-only</i> |
+
+### Images Properties ###
+
+|  Attribute   |   Type  |                                      Description                                       |
+| ------------ | ------- | -------------------------------------------------------------------------------------- |
+| `id`         | integer | Image ID (attachment ID)                                                               |
+| `created_at` | string  | UTC DateTime when the image was created <i class="label label-info">read-only</i>      |
+| `updated_at` | string  | UTC DateTime when the image was last updated <i class="label label-info">read-only</i> |
+| `src`        | string  | Image URL. In write-mode you can use to send new images                                |
+| `title`      | string  | Image title (attachment title) <i class="label label-info">read-only</i>               |
+| `alt`        | string  | Image alt text (attachment image alt text) <i class="label label-info">read-only</i>   |
+| `position`   | integer | Image position. `0` means that the image is featured                                   |
+
+### Attributes Properties ###
+
+|  Attribute  |   Type  |                                            Description                                             |
+| ----------- | ------- | -------------------------------------------------------------------------------------------------- |
+| `name`      | string  | Attribute name <i class="label label-info">required</i>                                            |
+| `slug`      | string  | Attribute slug                                                                                     |
+| `position`  | integer | Attribute position                                                                                 |
+| `visible`   | boolean | Shows/define if the attribute is visible on the "Additional Information" tab in the product's page |
+| `variation` | boolean | Shows/define if the attribute can be used as variation                                             |
+| `options`   | array   | List of available term names of the attribute                                                      |
+
+### Default Attributes Properties ###
+
+| Attribute |  Type  |             Description             |
+| --------- | ------ | ----------------------------------- |
+| `name`    | string | Attribute name                      |
+| `slug`    | string | Attribute slug                      |
+| `option`  | string | Selected term name of the attribute |
+
+### Downloads Properties ###
+
+| Attribute |  Type  |                             Description                             |
+| --------- | ------ | ------------------------------------------------------------------- |
+| `id`      | string | File ID (file md5 hash) <i class="label label-info">read-only</i>   |
+| `name`    | string | File name                                                           |
+| `file`    | string | File URL. In write-mode you can use this property to send new files |
+
+### Variations Properties ###
+
+|        Attribute        |   Type  |                                                                                              Description                                                                                               |
+| ----------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `id`                    | integer | Variation ID (post ID) <i class="label label-info">read-only</i>                                                                                                                                       |
+| `created_at`            | string  | UTC DateTime when the variation was created <i class="label label-info">read-only</i>                                                                                                                  |
+| `updated_at`            | string  | UTC DateTime when the variation was last updated <i class="label label-info">read-only</i>                                                                                                             |
+| `downloadable`          | boolean | If the variation is downloadable or not. Downloadable variations give access to a file upon purchase                                                                                                   |
+| `virtual`               | boolean | If the variation is virtual or not. Virtual variations are intangible and aren't shipped                                                                                                               |
+| `permalink`             | string  | Variation URL (post permalink) <i class="label label-info">read-only</i>                                                                                                                               |
+| `sku`                   | string  | SKU refers to a Stock-keeping unit, a unique identifier for each distinct product and service that can be purchased                                                                                    |
+| `price`                 | float   | Current variation price. This is setted from `regular_price` and `sale_price` <i class="label label-info">read-only</i>                                                                                |
+| `regular_price`         | float   | Variation regular price                                                                                                                                                                                |
+| `sale_price`            | float   | Variation sale price                                                                                                                                                                                   |
+| `sale_price_dates_from` | float   | Sets the sale start date. Date in the `YYYY-MM-DD` format <i class="label label-info">write-only</i>                                                                                                   |
+| `sale_price_dates_to`   | float   | Sets the sale end date. Date in the `YYYY-MM-DD` format <i class="label label-info">write-only</i>                                                                                                     |
+| `taxable`               | boolean | Show if the variation is taxable or not <i class="label label-info">read-only</i>                                                                                                                      |
+| `tax_status`            | string  | Tax status. The options are: `taxable`, `shipping` (Shipping only) and `none`                                                                                                                          |
+| `tax_class`             | string  | Tax class                                                                                                                                                                                              |
+| `managing_stock`        | boolean | Enable stock management at variation level                                                                                                                                                             |
+| `stock_quantity`        | integer | Stock quantity. If is a variable variation this value will be used to control stock for all variations, unless you define stock at variation level.                                                    |
+| `in_stock`              | boolean | Controls whether or not the variation is listed as "in stock" or "out of stock" on the frontend.                                                                                                       |
+| `backordered`           | boolean | Shows if a variation is on backorder (if the variation have the stock_quantity negative) <i class="label label-info">read-only</i>                                                                     |
+| `purchaseable`          | boolean | Shows if the variation can be bought <i class="label label-info">read-only</i>                                                                                                                         |
+| `visible`               | boolean | Shows whether or not the product parent is visible in the catalog <i class="label label-info">read-only</i>                                                                                            |
+| `on_sale`               | boolean | Shows if the variation is on sale or not <i class="label label-info">read-only</i>                                                                                                                     |
+| `weight`                | string  | Variation weight in decimal format                                                                                                                                                                     |
+| `dimensions`            | array   | List of the variation dimensions. See [Dimensions Properties](#dimensions-properties)                                                                                                                  |
+| `shipping_class`        | string  | Shipping class slug. Shipping classes are used by certain shipping methods to group similar products                                                                                                   |
+| `shipping_class_id`     | integer | Shipping class ID <i class="label label-info">read-only</i>                                                                                                                                            |
+| `images`                | array   | Variation featured image. See [Images Properties](#images-properties)                                                                                                                                  |
+| `attributes`            | array   | List of variation attributes. Similar to a `simple` or `variable` product, but for `variation` indicate the attributes used to form the variation. See [Attributes Properties](#attributes-properties) |
+| `downloads`             | array   | List of downloadable files. See [Downloads Properties](#downloads-properties)                                                                                                                          |
+| `download_limit`        | integer | Amount of times the variation can be downloaded. In write-mode you can sent a blank string for unlimited re-downloads. e.g `''`                                                                        |
+| `download_expiry`       | integer | Number of days that the customer has up to be able to download the varition. In write-mode you can sent a blank string for never expiry. e.g `''`                                                      |
+
+## Create A Product ##
+
+This API helps you to create a new product.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-post">POST</i>
+		<h6>/wc-api/v2/products</h6>
+	</div>
+</div>
+
+> Example of how to create a `simple` product:
+
+```shell
+curl -X POST https://example.com/wc-api/v2/products \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "product": {
+    "title": "Premium Quality",
+    "type": "simple",
+    "regular_price": "21.99",
+    "description": "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",
+    "short_description": "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.",
+    "categories": [
+      9,
+      14
+    ],
+    "images": [
+      {
+        "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
+        "position": 0
+      },
+      {
+        "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-back.jpg",
+        "position": 1
+      }
+    ]
+  }
+}'
+```
+
+```javascript
+var data = {
+  product: {
+    title: 'Premium Quality',
+    type: 'simple',
+    regular_price: '21.99',
+    description: 'Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.',
+    short_description: 'Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.',
+    categories: [
+      9,
+      14
+    ],
+    images: [
+      {
+        src: 'http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg',
+        position: 0
+      },
+      {
+        src: 'http://example.com/wp-content/uploads/2015/01/premium-quality-back.jpg',
+        position: 1
+      }
+    ]
+  }
+};
+
+WooCommerce.post('products', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "product": {
+        "title": "Premium Quality",
+        "type": "simple",
+        "regular_price": "21.99",
+        "description": "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",
+        "short_description": "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.",
+        "categories": [
+            9,
+            14
+        ],
+        "images": [
+            {
+                "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
+                "position": 0
+            },
+            {
+                "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-back.jpg",
+                "position": 1
+            }
+        ]
+    }
+}
+
+print(wcapi.post("products", data).json())
+```
+
+```php
+<?php
+$data = array(
+    'product' => array(
+        'title' => 'Premium Quality',
+        'type' => 'simple',
+        'regular_price' => '21.99',
+        'description' => 'Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.',
+        'short_description' => 'Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.',
+        'categories' => array(
+            9,
+            14
+        ),
+        'images' => array(
+            array(
+                'src' => 'http =>//example.com/wp-content/uploads/2015/01/premium-quality-front.jpg',
+                'position' => 0
+            ),
+            array(
+                'src' => 'http =>//example.com/wp-content/uploads/2015/01/premium-quality-back.jpg',
+                'position' => 1
+            )
+        )
+    )
+);
+
+print_r($woocommerce->products->create($data));
+?>
+```
+
+```ruby
+data = {
+  product: {
+    title: "Premium Quality",
+    type: "simple",
+    regular_price: "21.99",
+    description: "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",
+    short_description: "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.",
+    categories: [
+      9,
+      14
+    ],
+    images: [
+      {
+        src: "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
+        position: 0
+      },
+      {
+        src: "http://example.com/wp-content/uploads/2015/01/premium-quality-back.jpg",
+        position: 1
+      }
+    ]
+  }
+}
+
+woocommerce.post("products", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "product": {
+    "title": "Premium Quality",
+    "id": 546,
+    "created_at": "2015-01-22T19:46:16Z",
+    "updated_at": "2015-01-22T19:46:16Z",
+    "type": "simple",
+    "status": "publish",
+    "downloadable": false,
+    "virtual": false,
+    "permalink": "https://example.com/product/premium-quality/",
+    "sku": "",
+    "price": "21.99",
+    "regular_price": "21.99",
+    "sale_price": null,
+    "price_html": "<span class=\"amount\">&#36;&nbsp;21.99</span>",
+    "taxable": true,
+    "tax_status": "taxable",
+    "tax_class": "",
+    "managing_stock": false,
+    "stock_quantity": 0,
+    "in_stock": true,
+    "backorders_allowed": false,
+    "backordered": false,
+    "sold_individually": false,
+    "purchaseable": true,
+    "featured": false,
+    "visible": true,
+    "catalog_visibility": "visible",
+    "on_sale": false,
+    "weight": null,
+    "dimensions": {
+      "length": "",
+      "width": "",
+      "height": "",
+      "unit": "cm"
+    },
+    "shipping_required": true,
+    "shipping_taxable": true,
+    "shipping_class": "",
+    "shipping_class_id": null,
+    "description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.</p>\n",
+    "short_description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.</p>\n",
+    "reviews_allowed": true,
+    "average_rating": "0.00",
+    "rating_count": 0,
+    "related_ids": [
+      37,
+      47,
+      31,
+      19,
+      22
+    ],
+    "upsell_ids": [],
+    "cross_sell_ids": [],
+    "parent_id": 0,
+    "categories": [
+      "Clothing",
+      "T-shirts"
+    ],
+    "tags": [],
+    "images": [
+      {
+        "id": 547,
+        "created_at": "2015-01-22T19:46:16Z",
+        "updated_at": "2015-01-22T19:46:16Z",
+        "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
+        "title": "",
+        "alt": "",
+        "position": 0
+      },
+      {
+        "id": 548,
+        "created_at": "2015-01-22T19:46:17Z",
+        "updated_at": "2015-01-22T19:46:17Z",
+        "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-back.jpg",
+        "title": "",
+        "alt": "",
+        "position": 1
+      }
+    ],
+    "featured_src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
+    "attributes": [],
+    "downloads": [],
+    "download_limit": 0,
+    "download_expiry": 0,
+    "download_type": "",
+    "purchase_note": "",
+    "total_sales": 0,
+    "variations": [],
+    "parent": []
+  }
+}
+```
+
+> Example of how to create a `variable` product:
+
+```shell
+curl -X POST https://example.com/wc-api/v2/products \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "product": {
+    "title": "Ship Your Idea",
+    "type": "variable",
+    "description": "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",
+    "short_description": "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.",
+    "categories": [
+      9,
+      14
+    ],
+    "images": [
+      {
+        "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
+        "position": 0
+      },
+      {
+        "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-back.jpg",
+        "position": 1
+      },
+      {
+        "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
+        "position": 2
+      },
+      {
+        "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-back.jpg",
+        "position": 3
+      }
+    ],
+    "attributes": [
+      {
+        "name": "Color",
+        "slug": "color",
+        "position": "0",
+        "visible": false,
+        "variation": true,
+        "options": [
+          "Black",
+          "Green"
+        ]
+      }
+    ],
+    "default_attributes": [
+      {
+        "name": "Color",
+        "slug": "color",
+        "option": "Black"
+      }
+    ],
+    "variations": [
+      {
+        "regular_price": "19.99",
+        "image": [
+          {
+            "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
+            "position": 0
+          }
+        ],
+        "attributes": [
+          {
+            "name": "Color",
+            "slug": "color",
+            "option": "black"
+          }
+        ]
+      },
+      {
+        "regular_price": "19.99",
+        "image": [
+          {
+            "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
+            "position": 0
+          }
+        ],
+        "attributes": [
+          {
+            "name": "Color",
+            "slug": "color",
+            "option": "green"
+          }
+        ]
+      }
+    ]
+  }
+}'
+```
+
+```javascript
+var data = {
+  product: {
+    title: 'Ship Your Idea',
+    type: 'variable',
+    description: 'Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.',
+    short_description: 'Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.',
+    categories: [
+      9,
+      14
+    ],
+    images: [
+      {
+        src: 'http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg',
+        position: 0
+      },
+      {
+        src: 'http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-back.jpg',
+        position: 1
+      },
+      {
+        src: 'http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg',
+        position: 2
+      },
+      {
+        src: 'http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-back.jpg',
+        position: 3
+      }
+    ],
+    attributes: [
+      {
+        name: 'Color',
+        slug: 'color',
+        position: '0',
+        visible: false,
+        variation: true,
+        options: [
+          'Black',
+          'Green'
+        ]
+      }
+    ],
+    default_attributes: [
+      {
+        name: 'Color',
+        slug: 'color',
+        option: 'Black'
+      }
+    ],
+    variations: [
+      {
+        regular_price: '19.99',
+        image: [
+          {
+            src: 'http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg',
+            position: 0
+          }
+        ],
+        attributes: [
+          {
+            name: 'Color',
+            slug: 'color',
+            option: 'black'
+          }
+        ]
+      },
+      {
+        regular_price: '19.99',
+        image: [
+          {
+            src: 'http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg',
+            position: 0
+          }
+        ],
+        attributes: [
+          {
+            name: 'Color',
+            slug: 'color',
+            option: 'green'
+          }
+        ]
+      }
+    ]
+  }
+};
+
+WooCommerce.post('products', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "product": {
+        "title": "Ship Your Idea",
+        "type": "variable",
+        "description": "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",
+        "short_description": "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.",
+        "categories": [
+            9,
+            14
+        ],
+        "images": [
+            {
+                "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
+                "position": 0
+            },
+            {
+                "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-back.jpg",
+                "position": 1
+            },
+            {
+                "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
+                "position": 2
+            },
+            {
+                "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-back.jpg",
+                "position": 3
+            }
+        ],
+        "attributes": [
+            {
+                "name": "Color",
+                "slug": "color",
+                "position": "0",
+                "visible": False,
+                "variation": True,
+                "options": [
+                    "Black",
+                    "Green"
+                ]
+            }
+        ],
+        "default_attributes": [
+            {
+                "name": "Color",
+                "slug": "color",
+                "option": "Black"
+            }
+        ],
+        "variations": [
+            {
+                "regular_price": "19.99",
+                "image": [
+                    {
+                        "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
+                        "position": 0
+                    }
+                ],
+                "attributes": [
+                    {
+                        "name": "Color",
+                        "slug": "color",
+                        "option": "black"
+                    }
+                ]
+            },
+            {
+                "regular_price": "19.99",
+                "image": [
+                    {
+                        "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
+                        "position": 0
+                    }
+                ],
+                "attributes": [
+                    {
+                        "name": "Color",
+                        "slug": "color",
+                        "option": "green"
+                    }
+                ]
+            }
+        ]
+    }
+}
+
+print(wcapi.post("products", data).json())
+```
+
+```php
+<?php
+$data = array(
+    'product' => array(
+        'title' => 'Ship Your Idea',
+        'type' => 'variable',
+        'description' => 'Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.',
+        'short_description' => 'Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.',
+        'categories' => array(
+            9,
+            14
+        ),
+        'images' => array(
+            array(
+                'src' => 'http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg',
+                'position' => 0
+            ),
+            array(
+                'src' => 'http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-back.jpg',
+                'position' => 1
+            ),
+            array(
+                'src' => 'http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg',
+                'position' => 2
+            ),
+            array(
+                'src' => 'http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-back.jpg',
+                'position' => 3
+            )
+        ),
+        'attributes' => array(
+            array(
+                'name' => 'Color',
+                'slug' => 'color',
+                'position' => '0',
+                'visible' => False,
+                'variation' => True,
+                'options' => array(
+                    'Black',
+                    'Green'
+                )
+            )
+        ),
+        'default_attributes' => array(
+            array(
+                'name' => 'Color',
+                'slug' => 'color',
+                'option' => 'Black'
+            )
+        ),
+        'variations' => array(
+            array(
+                'regular_price' => '19.99',
+                'image' => array(
+                    array(
+                        'src' => 'http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg',
+                        'position' => 0
+                    )
+                ),
+                'attributes' => array(
+                    array(
+                        'name' => 'Color',
+                        'slug' => 'color',
+                        'option' => 'black'
+                    )
+                )
+            ),
+            array(
+                'regular_price' => '19.99',
+                'image' => array(
+                    array(
+                        'src' => 'http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg',
+                        'position' => 0
+                    )
+                ),
+                'attributes' => array(
+                    array(
+                        'name' => 'Color',
+                        'slug' => 'color',
+                        'option' => 'green'
+                    )
+                )
+            )
+        )
+    )
+);
+
+print_r($woocommerce->products->create($data));
+?>
+```
+
+```ruby
+data = {
+  product: {
+    title: "Ship Your Idea",
+    type: "variable",
+    description: "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",
+    short_description: "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.",
+    categories: [
+      9,
+      14
+    ],
+    images: [
+      {
+        src: "http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
+        position: 0
+      },
+      {
+        src: "http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-back.jpg",
+        position: 1
+      },
+      {
+        src: "http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
+        position: 2
+      },
+      {
+        src: "http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-back.jpg",
+        position: 3
+      }
+    ],
+    attributes: [
+      {
+        name: "Color",
+        slug: "color",
+        position: "0",
+        visible: false,
+        variation: true,
+        options: [
+          "Black",
+          "Green"
+        ]
+      }
+    ],
+    default_attributes: [
+      {
+        name: "Color",
+        slug: "color",
+        option: "Black"
+      }
+    ],
+    variations: [
+      {
+        regular_price: "19.99",
+        image: [
+          {
+            src: "http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
+            position: 0
+          }
+        ],
+        attributes: [
+          {
+            name: "Color",
+            slug: "color",
+            option: "black"
+          }
+        ]
+      },
+      {
+        regular_price: "19.99",
+        image: [
+          {
+            src: "http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
+            position: 0
+          }
+        ],
+        attributes: [
+          {
+            name: "Color",
+            slug: "color",
+            option: "green"
+          }
+        ]
+      }
+    ]
+  }
+}
+
+woocommerce.post("products", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "product": {
+    "title": "Ship Your Idea",
+    "id": 604,
+    "created_at": "2015-01-22T20:37:14Z",
+    "updated_at": "2015-01-22T20:37:14Z",
+    "type": "variable",
+    "status": "publish",
+    "downloadable": false,
+    "virtual": false,
+    "permalink": "https://example/product/ship-your-idea/",
+    "sku": "",
+    "price": "19.99",
+    "regular_price": "0.00",
+    "sale_price": null,
+    "price_html": "<span class=\"amount\">&#36;&nbsp;19.99</span>",
+    "taxable": true,
+    "tax_status": "taxable",
+    "tax_class": "",
+    "managing_stock": false,
+    "stock_quantity": 0,
+    "in_stock": true,
+    "backorders_allowed": false,
+    "backordered": false,
+    "sold_individually": false,
+    "purchaseable": true,
+    "featured": false,
+    "visible": true,
+    "catalog_visibility": "visible",
+    "on_sale": false,
+    "weight": null,
+    "dimensions": {
+      "length": "",
+      "width": "",
+      "height": "",
+      "unit": "cm"
+    },
+    "shipping_required": true,
+    "shipping_taxable": true,
+    "shipping_class": "",
+    "shipping_class_id": null,
+    "description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.</p>\n",
+    "short_description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.</p>\n",
+    "reviews_allowed": true,
+    "average_rating": "0.00",
+    "rating_count": 0,
+    "related_ids": [
+      40,
+      37,
+      47,
+      577,
+      34
+    ],
+    "upsell_ids": [],
+    "cross_sell_ids": [],
+    "parent_id": 0,
+    "categories": [
+      "Clothing",
+      "T-shirts"
+    ],
+    "tags": [],
+    "images": [
+      {
+        "id": 605,
+        "created_at": "2015-01-22T20:37:14Z",
+        "updated_at": "2015-01-22T20:37:14Z",
+        "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
+        "title": "",
+        "alt": "",
+        "position": 0
+      },
+      {
+        "id": 606,
+        "created_at": "2015-01-22T20:37:15Z",
+        "updated_at": "2015-01-22T20:37:15Z",
+        "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-back.jpg",
+        "title": "",
+        "alt": "",
+        "position": 1
+      },
+      {
+        "id": 607,
+        "created_at": "2015-01-22T20:37:15Z",
+        "updated_at": "2015-01-22T20:37:15Z",
+        "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
+        "title": "",
+        "alt": "",
+        "position": 2
+      },
+      {
+        "id": 608,
+        "created_at": "2015-01-22T20:37:16Z",
+        "updated_at": "2015-01-22T20:37:16Z",
+        "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-green-back.jpg",
+        "title": "",
+        "alt": "",
+        "position": 3
+      }
+    ],
+    "featured_src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
+    "attributes": [
+      {
+        "name": "Color",
+        "slug": "color",
+        "position": 0,
+        "visible": false,
+        "variation": true,
+        "options": [
+          "Black",
+          "Green"
+        ]
+      }
+    ],
+    "downloads": [],
+    "download_limit": 0,
+    "download_expiry": 0,
+    "download_type": "",
+    "purchase_note": "",
+    "total_sales": 0,
+    "variations": [
+      {
+        "id": 609,
+        "created_at": "2015-01-22T20:37:14Z",
+        "updated_at": "2015-01-22T20:37:14Z",
+        "downloadable": false,
+        "virtual": false,
+        "permalink": "https://example/product/ship-your-idea-10/?attribute_pa_color=black",
+        "sku": "",
+        "price": "19.99",
+        "regular_price": "19.99",
+        "sale_price": null,
+        "taxable": true,
+        "tax_status": "taxable",
+        "tax_class": "",
+        "managing_stock": false,
+        "stock_quantity": 0,
+        "in_stock": true,
+        "backordered": false,
+        "purchaseable": true,
+        "visible": true,
+        "on_sale": false,
+        "weight": null,
+        "dimensions": {
+          "length": "",
+          "width": "",
+          "height": "",
+          "unit": "cm"
+        },
+        "shipping_class": "",
+        "shipping_class_id": null,
+        "image": [
+          {
+            "id": 610,
+            "created_at": "2015-01-22T20:37:18Z",
+            "updated_at": "2015-01-22T20:37:18Z",
+            "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
+            "title": "",
+            "alt": "",
+            "position": 0
+          }
+        ],
+        "attributes": [
+          {
+            "name": "Color",
+            "slug": "color",
+            "option": "black"
+          }
+        ],
+        "downloads": [],
+        "download_limit": 0,
+        "download_expiry": 0
+      },
+      {
+        "id": 611,
+        "created_at": "2015-01-22T20:37:14Z",
+        "updated_at": "2015-01-22T20:37:14Z",
+        "downloadable": false,
+        "virtual": false,
+        "permalink": "https://example/product/ship-your-idea-10/?attribute_pa_color=green",
+        "sku": "",
+        "price": "19.99",
+        "regular_price": "19.99",
+        "sale_price": null,
+        "taxable": true,
+        "tax_status": "taxable",
+        "tax_class": "",
+        "managing_stock": false,
+        "stock_quantity": 0,
+        "in_stock": true,
+        "backordered": false,
+        "purchaseable": true,
+        "visible": true,
+        "on_sale": false,
+        "weight": null,
+        "dimensions": {
+          "length": "",
+          "width": "",
+          "height": "",
+          "unit": "cm"
+        },
+        "shipping_class": "",
+        "shipping_class_id": null,
+        "image": [
+          {
+            "id": 612,
+            "created_at": "2015-01-22T20:37:19Z",
+            "updated_at": "2015-01-22T20:37:19Z",
+            "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
+            "title": "",
+            "alt": "",
+            "position": 0
+          }
+        ],
+        "attributes": [
+          {
+            "name": "Color",
+            "slug": "color",
+            "option": "green"
+          }
+        ],
+        "downloads": [],
+        "download_limit": 0,
+        "download_expiry": 0
+      }
+    ],
+    "parent": []
+  }
+}
+```
+
+## View A Product ##
+
+This API lets you retrieve and view a specific product by ID or sku.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/products/&lt;id&gt;</h6>
+	</div>
+</div>
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/products/sku/&lt;sku&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/products/546 \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('products/546', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("products/546").json())
+```
+
+```php
+<?php print_r($woocommerce->products->get(546)); ?>
+```
+
+```ruby
+woocommerce.get("products/546").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "product": {
+    "title": "Premium Quality",
+    "id": 546,
+    "created_at": "2015-01-22T19:46:16Z",
+    "updated_at": "2015-01-22T19:46:16Z",
+    "type": "simple",
+    "status": "publish",
+    "downloadable": false,
+    "virtual": false,
+    "permalink": "https://example.com/product/premium-quality/",
+    "sku": "",
+    "price": "21.99",
+    "regular_price": "21.99",
+    "sale_price": null,
+    "price_html": "<span class=\"amount\">&#36;&nbsp;21.99</span>",
+    "taxable": true,
+    "tax_status": "taxable",
+    "tax_class": "",
+    "managing_stock": false,
+    "stock_quantity": 0,
+    "in_stock": true,
+    "backorders_allowed": false,
+    "backordered": false,
+    "sold_individually": false,
+    "purchaseable": true,
+    "featured": false,
+    "visible": true,
+    "catalog_visibility": "visible",
+    "on_sale": false,
+    "weight": null,
+    "dimensions": {
+      "length": "",
+      "width": "",
+      "height": "",
+      "unit": "cm"
+    },
+    "shipping_required": true,
+    "shipping_taxable": true,
+    "shipping_class": "",
+    "shipping_class_id": null,
+    "description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.</p>\n",
+    "short_description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.</p>\n",
+    "reviews_allowed": true,
+    "average_rating": "0.00",
+    "rating_count": 0,
+    "related_ids": [
+      37,
+      47,
+      31,
+      19,
+      22
+    ],
+    "upsell_ids": [],
+    "cross_sell_ids": [],
+    "parent_id": 0,
+    "categories": [
+      "Clothing",
+      "T-shirts"
+    ],
+    "tags": [],
+    "images": [
+      {
+        "id": 547,
+        "created_at": "2015-01-22T19:46:16Z",
+        "updated_at": "2015-01-22T19:46:16Z",
+        "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
+        "title": "",
+        "alt": "",
+        "position": 0
+      },
+      {
+        "id": 548,
+        "created_at": "2015-01-22T19:46:17Z",
+        "updated_at": "2015-01-22T19:46:17Z",
+        "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-back.jpg",
+        "title": "",
+        "alt": "",
+        "position": 1
+      }
+    ],
+    "featured_src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
+    "attributes": [],
+    "downloads": [],
+    "download_limit": 0,
+    "download_expiry": 0,
+    "download_type": "",
+    "purchase_note": "",
+    "total_sales": 0,
+    "variations": [],
+    "parent": []
+  }
+}
+```
+
+## View List Of Products ##
+
+This API helps you to view all the products.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/products</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/products \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('products', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("products").json())
+```
+
+```php
+<?php print_r($woocommerce->products->get()); ?>
+```
+
+```ruby
+woocommerce.get("products").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "products": [
+    {
+      "title": "Premium Quality",
+      "id": 546,
+      "created_at": "2015-01-22T19:46:16Z",
+      "updated_at": "2015-01-22T19:46:16Z",
+      "type": "simple",
+      "status": "publish",
+      "downloadable": false,
+      "virtual": false,
+      "permalink": "https://example.com/product/premium-quality/",
+      "sku": "",
+      "price": "21.99",
+      "regular_price": "21.99",
+      "sale_price": null,
+      "price_html": "<span class=\"amount\">&#36;&nbsp;21.99</span>",
+      "taxable": true,
+      "tax_status": "taxable",
+      "tax_class": "",
+      "managing_stock": false,
+      "stock_quantity": 0,
+      "in_stock": true,
+      "backorders_allowed": false,
+      "backordered": false,
+      "sold_individually": false,
+      "purchaseable": true,
+      "featured": false,
+      "visible": true,
+      "catalog_visibility": "visible",
+      "on_sale": false,
+      "weight": null,
+      "dimensions": {
+        "length": "",
+        "width": "",
+        "height": "",
+        "unit": "cm"
+      },
+      "shipping_required": true,
+      "shipping_taxable": true,
+      "shipping_class": "",
+      "shipping_class_id": null,
+      "description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.</p>\n",
+      "short_description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.</p>\n",
+      "reviews_allowed": true,
+      "average_rating": "0.00",
+      "rating_count": 0,
+      "related_ids": [
+        37,
+        47,
+        31,
+        19,
+        22
+      ],
+      "upsell_ids": [],
+      "cross_sell_ids": [],
+      "parent_id": 0,
+      "categories": [
+        "Clothing",
+        "T-shirts"
+      ],
+      "tags": [],
+      "images": [
+        {
+          "id": 547,
+          "created_at": "2015-01-22T19:46:16Z",
+          "updated_at": "2015-01-22T19:46:16Z",
+          "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
+          "title": "",
+          "alt": "",
+          "position": 0
+        },
+        {
+          "id": 548,
+          "created_at": "2015-01-22T19:46:17Z",
+          "updated_at": "2015-01-22T19:46:17Z",
+          "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-back.jpg",
+          "title": "",
+          "alt": "",
+          "position": 1
+        }
+      ],
+      "featured_src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
+      "attributes": [],
+      "downloads": [],
+      "download_limit": 0,
+      "download_expiry": 0,
+      "download_type": "",
+      "purchase_note": "",
+      "total_sales": 0,
+      "variations": [],
+      "parent": []
+    },
+    {
+      "title": "Ship Your Idea",
+      "id": 604,
+      "created_at": "2015-01-22T20:37:14Z",
+      "updated_at": "2015-01-22T20:37:14Z",
+      "type": "variable",
+      "status": "publish",
+      "downloadable": false,
+      "virtual": false,
+      "permalink": "https://example/product/ship-your-idea/",
+      "sku": "",
+      "price": "19.99",
+      "regular_price": "0.00",
+      "sale_price": null,
+      "price_html": "<span class=\"amount\">&#36;&nbsp;19.99</span>",
+      "taxable": true,
+      "tax_status": "taxable",
+      "tax_class": "",
+      "managing_stock": false,
+      "stock_quantity": 0,
+      "in_stock": true,
+      "backorders_allowed": false,
+      "backordered": false,
+      "sold_individually": false,
+      "purchaseable": true,
+      "featured": false,
+      "visible": true,
+      "catalog_visibility": "visible",
+      "on_sale": false,
+      "weight": null,
+      "dimensions": {
+        "length": "",
+        "width": "",
+        "height": "",
+        "unit": "cm"
+      },
+      "shipping_required": true,
+      "shipping_taxable": true,
+      "shipping_class": "",
+      "shipping_class_id": null,
+      "description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.</p>\n",
+      "short_description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.</p>\n",
+      "reviews_allowed": true,
+      "average_rating": "0.00",
+      "rating_count": 0,
+      "related_ids": [
+        40,
+        37,
+        47,
+        577,
+        34
+      ],
+      "upsell_ids": [],
+      "cross_sell_ids": [],
+      "parent_id": 0,
+      "categories": [
+        "Clothing",
+        "T-shirts"
+      ],
+      "tags": [],
+      "images": [
+        {
+          "id": 605,
+          "created_at": "2015-01-22T20:37:14Z",
+          "updated_at": "2015-01-22T20:37:14Z",
+          "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
+          "title": "",
+          "alt": "",
+          "position": 0
+        },
+        {
+          "id": 606,
+          "created_at": "2015-01-22T20:37:15Z",
+          "updated_at": "2015-01-22T20:37:15Z",
+          "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-back.jpg",
+          "title": "",
+          "alt": "",
+          "position": 1
+        },
+        {
+          "id": 607,
+          "created_at": "2015-01-22T20:37:15Z",
+          "updated_at": "2015-01-22T20:37:15Z",
+          "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
+          "title": "",
+          "alt": "",
+          "position": 2
+        },
+        {
+          "id": 608,
+          "created_at": "2015-01-22T20:37:16Z",
+          "updated_at": "2015-01-22T20:37:16Z",
+          "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-green-back.jpg",
+          "title": "",
+          "alt": "",
+          "position": 3
+        }
+      ],
+      "featured_src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
+      "attributes": [
+        {
+          "name": "Color",
+          "slug": "color",
+          "position": 0,
+          "visible": false,
+          "variation": true,
+          "options": [
+            "Black",
+            "Green"
+          ]
+        }
+      ],
+      "downloads": [],
+      "download_limit": 0,
+      "download_expiry": 0,
+      "download_type": "",
+      "purchase_note": "",
+      "total_sales": 0,
+      "variations": [
+        {
+          "id": 609,
+          "created_at": "2015-01-22T20:37:14Z",
+          "updated_at": "2015-01-22T20:37:14Z",
+          "downloadable": false,
+          "virtual": false,
+          "permalink": "https://example/product/ship-your-idea-10/?attribute_pa_color=black",
+          "sku": "",
+          "price": "19.99",
+          "regular_price": "19.99",
+          "sale_price": null,
+          "taxable": true,
+          "tax_status": "taxable",
+          "tax_class": "",
+          "managing_stock": false,
+          "stock_quantity": 0,
+          "in_stock": true,
+          "backordered": false,
+          "purchaseable": true,
+          "visible": true,
+          "on_sale": false,
+          "weight": null,
+          "dimensions": {
+            "length": "",
+            "width": "",
+            "height": "",
+            "unit": "cm"
+          },
+          "shipping_class": "",
+          "shipping_class_id": null,
+          "image": [
+            {
+              "id": 610,
+              "created_at": "2015-01-22T20:37:18Z",
+              "updated_at": "2015-01-22T20:37:18Z",
+              "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
+              "title": "",
+              "alt": "",
+              "position": 0
+            }
+          ],
+          "attributes": [
+            {
+              "name": "Color",
+              "slug": "color",
+              "option": "black"
+            }
+          ],
+          "downloads": [],
+          "download_limit": 0,
+          "download_expiry": 0
+        },
+        {
+          "id": 611,
+          "created_at": "2015-01-22T20:37:14Z",
+          "updated_at": "2015-01-22T20:37:14Z",
+          "downloadable": false,
+          "virtual": false,
+          "permalink": "https://example/product/ship-your-idea-10/?attribute_pa_color=green",
+          "sku": "",
+          "price": "19.99",
+          "regular_price": "19.99",
+          "sale_price": null,
+          "taxable": true,
+          "tax_status": "taxable",
+          "tax_class": "",
+          "managing_stock": false,
+          "stock_quantity": 0,
+          "in_stock": true,
+          "backordered": false,
+          "purchaseable": true,
+          "visible": true,
+          "on_sale": false,
+          "weight": null,
+          "dimensions": {
+            "length": "",
+            "width": "",
+            "height": "",
+            "unit": "cm"
+          },
+          "shipping_class": "",
+          "shipping_class_id": null,
+          "image": [
+            {
+              "id": 612,
+              "created_at": "2015-01-22T20:37:19Z",
+              "updated_at": "2015-01-22T20:37:19Z",
+              "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
+              "title": "",
+              "alt": "",
+              "position": 0
+            }
+          ],
+          "attributes": [
+            {
+              "name": "Color",
+              "slug": "color",
+              "option": "green"
+            }
+          ],
+          "downloads": [],
+          "download_limit": 0,
+          "download_expiry": 0
+        }
+      ],
+      "parent": []
+    }
+  ]
+}
+```
+
+#### Available Filters ####
+
+|   Filter   |  Type  |                 Description                  |
+| ---------- | ------ | -------------------------------------------- |
+| `type`     | string | Products by type. eg: `simple` or `variable` |
+| `category` | string | Products by category.                        |
+| `sku`      | string | Filter a product by SKU.                     |
+
+## Update A Product ##
+
+This API lets you make changes to a product.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-put">PUT</i>
+		<h6>/wc-api/v2/products/&lt;id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl -X PUT https://example.com/wc-api/v2/products/546 \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "product": {
+    "regular_price": "24.54"
+  }
+}'
+```
+
+```javascript
+var data = {
+  product: {
+    regular_price: '24.54'
+  }
+};
+
+WooCommerce.put('products/546', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "product": {
+        "regular_price": "24.54"
+    }
+}
+
+print(wcapi.put("products/546", data).json())
+```
+
+```php
+<?php
+$data = array(
+    'product' => array(
+        'regular_price': '24.54'
+    )
+);
+
+print_r($woocommerce->products->update(546, $data));
+?>
+```
+
+```ruby
+data = {
+  product: {
+    regular_price: "24.54"
+  }
+}
+
+woocommerce.put("products/546", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "product": {
+    "title": "Premium Quality",
+    "id": 546,
+    "created_at": "2015-01-22T19:46:16Z",
+    "updated_at": "2015-01-22T19:55:31Z",
+    "type": "simple",
+    "status": "publish",
+    "downloadable": false,
+    "virtual": false,
+    "permalink": "https://example.com/product/premium-quality/",
+    "sku": "",
+    "price": "24.54",
+    "regular_price": "24.54",
+    "sale_price": null,
+    "price_html": "<span class=\"amount\">&#36;&nbsp;24.54</span>",
+    "taxable": true,
+    "tax_status": "taxable",
+    "tax_class": "",
+    "managing_stock": false,
+    "stock_quantity": 0,
+    "in_stock": true,
+    "backorders_allowed": false,
+    "backordered": false,
+    "sold_individually": false,
+    "purchaseable": true,
+    "featured": false,
+    "visible": true,
+    "catalog_visibility": "visible",
+    "on_sale": false,
+    "weight": null,
+    "dimensions": {
+      "length": "",
+      "width": "",
+      "height": "",
+      "unit": "cm"
+    },
+    "shipping_required": true,
+    "shipping_taxable": true,
+    "shipping_class": "",
+    "shipping_class_id": null,
+    "description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.</p>\n",
+    "short_description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.</p>\n",
+    "reviews_allowed": true,
+    "average_rating": "0.00",
+    "rating_count": 0,
+    "related_ids": [
+      37,
+      47,
+      31,
+      19,
+      22
+    ],
+    "upsell_ids": [],
+    "cross_sell_ids": [],
+    "parent_id": 0,
+    "categories": [
+      "Clothing",
+      "T-shirts"
+    ],
+    "tags": [],
+    "images": [
+      {
+        "id": 547,
+        "created_at": "2015-01-22T19:46:16Z",
+        "updated_at": "2015-01-22T19:46:16Z",
+        "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
+        "title": "",
+        "alt": "",
+        "position": 0
+      },
+      {
+        "id": 548,
+        "created_at": "2015-01-22T19:46:17Z",
+        "updated_at": "2015-01-22T19:46:17Z",
+        "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-back.jpg",
+        "title": "",
+        "alt": "",
+        "position": 1
+      }
+    ],
+    "featured_src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
+    "attributes": [],
+    "downloads": [],
+    "download_limit": 0,
+    "download_expiry": 0,
+    "download_type": "",
+    "purchase_note": "",
+    "total_sales": 0,
+    "variations": [],
+    "parent": []
+  }
+}
+```
+
+## Delete A Product ##
+
+This API helps you delete a product.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-delete">DELETE</i>
+		<h6>/wc-api/v2/products/&lt;id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl -X DELETE https://example.com/wc-api/v2/products/546/?force=true \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.delete('products/546/?force=true', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.delete("products/546/?force=true").json())
+```
+
+```php
+<?php print_r($woocommerce->products->delete(546, true)); ?>
+```
+
+```ruby
+woocommerce.delete("products/546").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "message": "Permanently deleted product"
+}
+```
+
+### Parameters ###
+
+| Parameter |  Type  |                                                                           Description                                                                            |
+| --------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `force`   | string | Use `true` whether to permanently delete the product, defaults to `false`. Note that permanently deleting the product will return HTTP 200 rather than HTTP 202. |
+
+## View Products Count ##
+
+This API lets you retrieve a count of all products.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/products/count</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/products/count \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('products/count', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("products/count").json())
+```
+
+```php
+<?php print_r($woocommerce->products->get_count()); ?>
+```
+
+```ruby
+woocommerce.get("products/count").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "count": 2
+}
+```
+
+#### Available Filters ####
+
+|   Filter   |  Type  |                 Description                  |
+| ---------- | ------ | -------------------------------------------- |
+| `type`     | string | Products by type. eg: `simple` or `variable` |
+| `category` | string | Products by category.                        |
+
+## View List Of Product Reviews ##
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/products/&lt;id&gt;/reviews</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/products/546/reviews \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('products/546/reviews', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("products/546/reviews").json())
+```
+
+```php
+<?php print_r($woocommerce->products->get_reviews(546)); ?>
+```
+
+```ruby
+woocommerce.get("products/546/reviews").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "product_reviews": [
+    {
+      "id": 4,
+      "created_at": "2013-06-07T11:57:45Z",
+      "review": "This t-shirt is awesome! Would recommend to everyone!\n\nI'm ordering mine next week",
+      "rating": "5",
+      "reviewer_name": "Andrew",
+      "reviewer_email": "andrew@example.com",
+      "verified": false
+    },
+    {
+      "id": 3,
+      "created_at": "2013-06-07T11:53:49Z",
+      "review": "Wonderful quality, and an awesome design. WooThemes ftw!",
+      "rating": "4",
+      "reviewer_name": "Cobus Bester",
+      "reviewer_email": "cobus@example.com",
+      "verified": false
+    }
+  ]
+}
+```
+
+### Product Reviews Properties ###
+
+|    Attribute     |   Type  |                                        Description                                        |
+| ---------------- | ------- | ----------------------------------------------------------------------------------------- |
+| `id`             | integer | Review ID (comment ID) <i class="label label-info">read-only</i>                          |
+| `created_at`     | string  | UTC DateTime when the review was created <i class="label label-info">read-only</i>        |
+| `rating`         | string  | Review rating (0 to 5) <i class="label label-info">read-only</i>                          |
+| `reviewer_name`  | string  | Reviewer name <i class="label label-info">read-only</i>                                   |
+| `reviewer_email` | string  | Reviewer email <i class="label label-info">read-only</i>                                  |
+| `verified`       | boolean | Shows if the reviewer bought the product or not <i class="label label-info">read-only</i> |
+
+## View A Product Category ##
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/products/categories/&lt;id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/products/categories/9 \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('products/categories/9', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("products/categories/9").json())
+```
+
+```php
+<?php print_r($woocommerce->products->get_categories(9)); ?>
+```
+
+```ruby
+woocommerce.get("products/categories/9").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "product_category": {
+    "id": 9,
+    "name": "Clothing",
+    "slug": "clothing",
+    "parent": 0,
+    "description": "",
+    "count": 23
+  }
+}
+```
+
+### Product Category Properties ###
+
+|   Attribute   |   Type  |                                        Description                                        |
+| ------------- | ------- | ----------------------------------------------------------------------------------------- |
+| `id`          | integer | Category ID (term ID) <i class="label label-info">read-only</i>                           |
+| `name`        | string  | Category Name <i class="label label-info">read-only</i>                                   |
+| `slug`        | string  | Category slug <i class="label label-info">read-only</i>                                   |
+| `parent`      | integer | Category parent <i class="label label-info">read-only</i>                                 |
+| `description` | string  | Category description <i class="label label-info">read-only</i>                            |
+| `count`       | boolean | Shows the quantity of products in this category <i class="label label-info">read-only</i> |
+
+## View List Of Product Categories ##
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/products/categories</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/products/categories \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('products/categories', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("products/categories").json())
+```
+
+```php
+<?php print_r($woocommerce->products->get_categories()); ?>
+```
+
+```ruby
+woocommerce.get("products/categories").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "product_categories": [
+    {
+      "id": 15,
+      "name": "Albums",
+      "slug": "albums",
+      "parent": 11,
+      "description": "",
+      "count": 4
+    },
+    {
+      "id": 9,
+      "name": "Clothing",
+      "slug": "clothing",
+      "parent": 0,
+      "description": "",
+      "count": 23
+    },
+    {
+      "id": 10,
+      "name": "Hoodies",
+      "slug": "hoodies",
+      "parent": 9,
+      "description": "",
+      "count": 6
+    },
+    {
+      "id": 11,
+      "name": "Music",
+      "slug": "music",
+      "parent": 0,
+      "description": "",
+      "count": 6
+    },
+    {
+      "id": 12,
+      "name": "Posters",
+      "slug": "posters",
+      "parent": 0,
+      "description": "",
+      "count": 5
+    },
+    {
+      "id": 13,
+      "name": "Singles",
+      "slug": "singles",
+      "parent": 11,
+      "description": "",
+      "count": 2
+    },
+    {
+      "id": 14,
+      "name": "T-shirts",
+      "slug": "t-shirts",
+      "parent": 9,
+      "description": "",
+      "count": 17
+    }
+  ]
+}
+```
+
+<aside class="notice">
+	View the <a href="#product-category-properties">Product Category Properties</a> for more details on this response.
+</aside>
diff --git a/source/includes/v3/_reports.md b/source/includes/v3/_reports.md
new file mode 100644
index 00000000..5500b340
--- /dev/null
+++ b/source/includes/v3/_reports.md
@@ -0,0 +1,259 @@
+# Reports #
+
+This section lists all API that can be used view reports.
+
+## Reports Filters ##
+
+Use the following filters for any type of report to specify the period of sales: 
+
+|   Filter   |  Type  |                                                                                Description                                                                                 |
+| ---------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `period`   | string | The supported periods are: `week`, `month`, `last_month`, and `year`. If you use an invalid period, `week` is used. If you don't specify a period, the current day is used |
+| `date_min` | string | Return sales for a specific start date. The date need to be in the `YYYY-MM-AA` format                                                                                     |
+| `date_max` | string | Return sales for a specific end date. The dates need to be in the `YYYY-MM-AA` format. Required to set the `filter[date_min]` too                                          |
+
+## View List Of Reports ##
+
+This API lets you retrieve and view a simple list of available reports.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/reports</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/reports \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('reports', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("reports").json())
+```
+
+```php
+<?php print_r($woocommerce->reports->get()); ?>
+```
+
+```ruby
+woocommerce.get("reports").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "reports": [
+    "sales",
+    "sales/top_sellers"
+  ]
+}
+```
+
+## View List Of Sales Report ##
+
+This API lets you retrieve and view a list of sales report.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/reports/sales</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/reports/sales?filter[date_min]=2015-01-18&filter[date_max]=2015-01-21 \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('reports/sales?filter[date_min]=2015-01-18&filter[date_max]=2015-01-21', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("reports/sales?filter[date_min]=2015-01-18&filter[date_max]=2015-01-21").json())
+```
+
+```php
+<?php
+$args = array(
+	'filter' => array(
+		'date_min' => '2015-01-18',
+		'date_max' => '2015-01-21'
+	)
+);
+
+print_r($woocommerce->reports->get_sales($args));
+?>
+```
+
+```ruby
+woocommerce.get("reports/sales?filter[date_min]=2015-01-18&filter[date_max]=2015-01-21").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "sales": {
+    "total_sales": "580.10",
+    "average_sales": "145.03",
+    "total_orders": 4,
+    "total_items": 31,
+    "total_tax": "26.10",
+    "total_shipping": "20.00",
+    "total_discount": "0.00",
+    "totals_grouped_by": "day",
+    "totals": {
+      "2015-01-18": {
+        "sales": "-17.00",
+        "orders": 1,
+        "items": 1,
+        "tax": "0.00",
+        "shipping": "0.00",
+        "discount": "0.00",
+        "customers": 0
+      },
+      "2015-01-19": {
+        "sales": "0.00",
+        "orders": 0,
+        "items": 0,
+        "tax": "0.00",
+        "shipping": "0.00",
+        "discount": "0.00",
+        "customers": 0
+      },
+      "2015-01-20": {
+        "sales": "0.00",
+        "orders": 0,
+        "items": 0,
+        "tax": "0.00",
+        "shipping": "0.00",
+        "discount": "0.00",
+        "customers": 0
+      },
+      "2015-01-21": {
+        "sales": "597.10",
+        "orders": 3,
+        "items": 30,
+        "tax": "26.10",
+        "shipping": "20.00",
+        "discount": "0.00",
+        "customers": 0
+      }
+    },
+    "total_customers": 0
+  }
+}
+```
+
+## View List Of Top Sellers Report ##
+
+This API lets you retrieve and view a list of top sellers report.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/reports/sales/top_sellers</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/reports/sales/top_sellers?filter[period]=last_month \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('reports/sales/top_sellers?filter[period]=last_month', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("reports/sales/top_sellers?filter[period]=last_month").json())
+```
+
+```php
+<?php
+$args = array(
+	'filter' => array(
+		'period' => 'last_month'
+	)
+);
+
+print_r($woocommerce->reports->get_top_sellers($args));
+?>
+```
+
+```ruby
+woocommerce.get("reports/sales/top_sellers?filter[period]=last_month").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "top_sellers": [
+    {
+      "title": "Happy Ninja",
+      "product_id": "37",
+      "quantity": "24"
+    },
+    {
+      "title": "Flying Ninja",
+      "product_id": "70",
+      "quantity": "14"
+    },
+    {
+      "title": "Happy Ninja",
+      "product_id": "53",
+      "quantity": "6"
+    },
+    {
+      "title": "Ninja Silhouette",
+      "product_id": "31",
+      "quantity": "3"
+    },
+    {
+      "title": "Woo Logo",
+      "product_id": "15",
+      "quantity": "3"
+    },
+    {
+      "title": "Woo Album #1",
+      "product_id": "83",
+      "quantity": "3"
+    },
+    {
+      "title": "Woo Album #4",
+      "product_id": "96",
+      "quantity": "1"
+    },
+    {
+      "title": "Premium Quality",
+      "product_id": "19",
+      "quantity": "1"
+    },
+    {
+      "title": "Ninja Silhouette",
+      "product_id": "56",
+      "quantity": "1"
+    }
+  ]
+}
+```
diff --git a/source/includes/v3/_webhooks.md b/source/includes/v3/_webhooks.md
new file mode 100644
index 00000000..145969b9
--- /dev/null
+++ b/source/includes/v3/_webhooks.md
@@ -0,0 +1,659 @@
+# Webhooks #
+
+This section lists all API that can be used to create, edit or otherwise manipulate webhooks.
+
+## Webhooks Properties ##
+
+|   Attribute    |   Type  |                                                                                                       Description                                                                                                       |
+| -------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `id`           | integer | The webhook ID (post ID) <i class="label label-info">read-only</i>                                                                                                                                                      |
+| `name`         | string  | A friendly name for the webhook, defaults to "Webhook created on &lt;date&gt;"                                                                                                                                          |
+| `status`       | string  | Webhook status, options are `active` (delivers payload), `paused` (does not deliver), or `disabled` (does not deliver due delivery failures)                                                                            |
+| `topic`        | string  | Webhook topic, e.g. `coupon.updated`. [See the complete list](#topics)                                                                                                                                                  |
+| `resource`     | string  | Webhook resource, e.g. `coupon` <i class="label label-info">read-only</i>                                                                                                                                               |
+| `event`        | string  | Webhook event, e.g. `updated` <i class="label label-info">read-only</i>                                                                                                                                                 |
+| `hooks`        | array   | WooCommerce action names associated with the webhook <i class="label label-info">read-only</i>                                                                                                                          |
+| `delivery_url` | string  | The URL where the webhook payload is delivered                                                                                                                                                                          |
+| `secret`       | string  | Secret key used to generate a hash of the delivered webhook and provided in the request headers. This will default to the current API user's consumer secret if not provided <i class="label label-info">write-only</i> |
+| `created_at`   | string  | UTC DateTime when the webhook was created <i class="label label-info">read-only</i>                                                                                                                                     |
+| `updated_at`   | string  | UTC DateTime when the webhook was last updated <i class="label label-info">read-only</i>                                                                                                                                |
+
+
+### Delivery Properties ###
+
+|     Attribute      |   Type  |                                                                                 Description                                                                                 |
+| ------------------ | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `id`               | integer | The delivery ID (comment ID)                                                                                                                                                |
+| `duration`         | string  | The delivery duration, in seconds                                                                                                                                           |
+| `summary`          | string  | A friendly summary of the response including the HTTP response code, message, and body                                                                                      |
+| `request_url`      | string  | The URL where the webhook was delivered                                                                                                                                     |
+| `request_headers`  | array   | Array of request headers (see [Request Headers Attributes](#request-headers-properties))                                                                                    |
+| `request_body`     | string  | The request body, this matches the API response for the given resource (e.g. for the coupon.updated topic, the request body would match the response for GET /coupons/{id}) |
+| `response_code`    | string  | The HTTP response code from the receiving server                                                                                                                            |
+| `response_message` | string  | The HTTP response message from the receiving server                                                                                                                         |
+| `response_headers` | array   | Array of the response headers from the receiving server                                                                                                                     |
+| `response_body`    | string  | The response body from the receiving server                                                                                                                                 |
+| `created_at`       | string  | A DateTime of when the delivery was logged                                                                                                                                  |
+
+#### Request Headers Properties ####
+
+|         Attribute          |   Type  |                                        Description                                         |
+| -------------------------- | ------- | ------------------------------------------------------------------------------------------ |
+| `User-Agent`               | string  | The request user agent, defaults to "WooCommerce/{version} Hookshot (WordPress/{version})" |
+| `Content-Type`             | string  | The request content-type, defaults to "application/json"                                   |
+| `X-WC-Webhook-Topic`       | string  | The webhook topic                                                                          |
+| `X-WC-Webhook-Resource`    | string  | The webhook resource                                                                       |
+| `X-WC-Webhook-Event`       | string  | The webhook event                                                                          |
+| `X-WC-Webhook-Signature`   | string  | A base64 encoded HMAC-SHA256 hash of the payload                                           |
+| `X-WC-Webhook-ID`          | integer | The webhook's ID                                                                           |
+| `X-WC-Webhook-Delivery-ID` | integer | The delivery ID                                                                            |
+
+## Create A Webhook ##
+
+This API helps you to create a new webhook.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-post">POST</i>
+		<h6>/wc-api/v2/webhooks</h6>
+	</div>
+</div>
+
+```shell
+curl -X POST https://example.com/wc-api/v2/webhooks \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "webhook": {
+    "name": "An add to cart webhook",
+    "secret": "my-super-secret-private-key",
+    "topic": "action.woocommerce_add_to_cart",
+    "delivery_url": "http://requestb.in/1exdwip1"
+  }
+}'
+```
+
+```javascript
+var data = {
+  webhook: {
+    name: 'An add to cart webhook',
+    secret: 'my-super-secret-private-key',
+    topic: 'action.woocommerce_add_to_cart',
+    delivery_url: 'http://requestb.in/1exdwip1'
+  }
+};
+
+WooCommerce.post('webhooks', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "webhook": {
+        "name": "An add to cart webhook",
+        "secret": "my-super-secret-private-key",
+        "topic": "action.woocommerce_add_to_cart",
+        "delivery_url": "http://requestb.in/1exdwip1"
+    }
+}
+
+print(wcapi.post("webhooks", data).json())
+```
+
+```php
+<?php
+$data = array(
+    'webhook' => array(
+        'name' => 'An add to cart webhook',
+        'secret' => 'my-super-secret-private-key',
+        'topic' => 'action.woocommerce_add_to_cart',
+        'delivery_url' => 'http://requestb.in/1exdwip1'
+    )
+);
+
+print_r($woocommerce->webhooks->create($data));
+?>
+```
+
+```ruby
+data = {
+  webhook: {
+    name: "An add to cart webhook",
+    secret: "my-super-secret-private-key",
+    topic: "action.woocommerce_add_to_cart",
+    delivery_url: "http://requestb.in/1exdwip1"
+  }
+}
+
+woocommerce.post("webhooks", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "webhook": {
+    "id": 535,
+    "name": "An add to cart webhook",
+    "status": "active",
+    "topic": "action.woocommerce_add_to_cart",
+    "resource": "action",
+    "event": "woocommerce_add_to_cart",
+    "hooks": [
+      "woocommerce_add_to_cart"
+    ],
+    "delivery_url": "http://requestb.in/1exdwip1",
+    "created_at": "2015-01-21T13:19:58Z",
+    "updated_at": "2015-01-21T13:19:58Z"
+  }
+}
+```
+
+## View A Webhook ##
+
+This API lets you retrieve and view a specific webhook.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/webhooks/&lt;id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/webhooks/535 \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('webhooks/535', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("webhooks/535").json())
+```
+
+```php
+<?php print_r($woocommerce->webhooks->get(535)); ?>
+```
+
+```ruby
+woocommerce.get("webhooks/535").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "webhook": {
+    "id": 535,
+    "name": "An add to cart webhook",
+    "status": "active",
+    "topic": "action.woocommerce_add_to_cart",
+    "resource": "action",
+    "event": "woocommerce_add_to_cart",
+    "hooks": [
+      "woocommerce_add_to_cart"
+    ],
+    "delivery_url": "http://requestb.in/1exdwip1",
+    "created_at": "2015-01-21T13:19:58Z",
+    "updated_at": "2015-01-21T13:19:58Z"
+  }
+}
+```
+
+## View List Of Webhooks ##
+
+This API helps you to view all the webhooks.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/webhooks</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/webhooks \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('webhooks', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("webhooks").json())
+```
+
+```php
+<?php print_r($woocommerce->webhooks->get()); ?>
+```
+
+```ruby
+woocommerce.get("webhooks").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "webhooks": [
+    {
+      "id": 535,
+      "name": "An add to cart webhook",
+      "status": "active",
+      "topic": "action.woocommerce_add_to_cart",
+      "resource": "action",
+      "event": "woocommerce_add_to_cart",
+      "hooks": [
+        "woocommerce_add_to_cart"
+      ],
+      "delivery_url": "http://requestb.in/1exdwip1",
+      "created_at": "2015-01-21T13:19:58Z",
+      "updated_at": "2015-01-21T13:19:58Z"
+    },
+    {
+      "id": 313,
+      "name": "Webhook created on Jan 17, 2015 @ 11:45 AM",
+      "status": "active",
+      "topic": "order.created",
+      "resource": "order",
+      "event": "created",
+      "hooks": [
+        "woocommerce_checkout_order_processed",
+        "woocommerce_process_shop_order_meta",
+        "woocommerce_api_create_order"
+      ],
+      "delivery_url": "http://requestb.in/1exdwip1",
+      "created_at": "2014-12-17T11:45:05Z",
+      "updated_at": "2015-01-10T00:41:08Z"
+    }
+  ]
+}
+```
+
+#### Available Filters ####
+
+|  Filter  |  Type  |                                         Description                                          |
+| -------- | ------ | -------------------------------------------------------------------------------------------- |
+| `status` | string | Webhooks by status. The following options are available: `active` or `paused` and `disabled` |
+
+## Update A Webhook ##
+
+This API lets you make changes to a webhook.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-put">PUT</i>
+		<h6>/wc-api/v2/webhook/&lt;id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl -X PUT https://example.com/wc-api/v2/webhook/535 \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "webhook": {
+    "status": "paused"
+  }
+}'
+```
+
+```javascript
+var data = {
+  webhook: {
+    status: 'paused'
+  }
+}
+
+WooCommerce.put('webhooks/535', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "webhook": {
+        "status": "paused"
+    }
+}
+
+print(wcapi.put("webhooks/535", data).json())
+```
+
+```php
+<?php
+$data = array(
+    'webhook' => array(
+        'status' => 'paused'
+    )
+);
+
+print_r($woocommerce->webhooks->updaste(535, $data));
+?>
+```
+
+```ruby
+data = {
+  webhook: {
+    status: "paused"
+  }
+}
+
+woocommerce.put("webhooks/535", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "webhook": {
+    "id": 535,
+    "name": "An add to cart webhook",
+    "status": "paused",
+    "topic": "action.woocommerce_add_to_cart",
+    "resource": "action",
+    "event": "woocommerce_add_to_cart",
+    "hooks": [
+      "woocommerce_add_to_cart"
+    ],
+    "delivery_url": "http://requestb.in/1exdwip1",
+    "created_at": "2015-01-21T13:19:58Z",
+    "updated_at": "2015-01-21T13:19:58Z"
+  }
+}
+```
+
+## Delete A Webhook ##
+
+This API helps you delete a webhook.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-delete">DELETE</i>
+		<h6>/wc-api/v2/webhooks/&lt;id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl -X DELETE https://example.com/wc-api/v2/webhooks/535 \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.delete('webhooks/535', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.delete("webhooks/535").json())
+```
+
+```php
+<?php print_r($woocommerce->webhooks->delete(535)); ?>
+```
+
+```ruby
+woocommerce.delete("webhooks/535").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "message": "Permanently deleted webhook"
+}
+```
+
+## View Webhooks Count ##
+
+This API lets you retrieve a count of all webhooks.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/webhooks/count</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/webhooks/count \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('webhooks/count', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("webhooks/count").json())
+```
+
+```php
+<?php print_r($woocommerce->webhooks->get_count()); ?>
+```
+
+```ruby
+woocommerce.get("webhooks/count").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "count": 4
+}
+```
+
+#### Available Filters ####
+
+|  Filter  |  Type  |                                         Description                                          |
+| -------- | ------ | -------------------------------------------------------------------------------------------- |
+| `status` | string | Webhooks by status. The following options are available: `active` or `paused` and `disabled` |
+
+## View A Webhooks Delivery ##
+
+This API lets you retrieve and view a specific webhook delivery.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/webhooks/&lt;id&gt;/deliveries/&lt;delivery_id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/webhooks/535/deliveries/378 \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('webhooks/535/deliveries/378', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("webhooks/535/deliveries/378").json())
+```
+
+```php
+<?php print_r($woocommerce->webhooks->get_deliveries(378)); ?>
+```
+
+```ruby
+woocommerce.get("webhooks/535/deliveries/378").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "webhook_delivery": {
+    "id": 378,
+    "duration": "0.90226",
+    "summary": "HTTP 200 OK: ok",
+    "request_method": "POST",
+    "request_url": "http://requestb.in/125q7ns1",
+    "request_headers": {
+      "User-Agent": "WooCommerce/2.3.0 Hookshot (WordPress/4.1)",
+      "Content-Type": "application/json",
+      "X-WC-Webhook-Topic": "action.woocommerce_add_to_cart",
+      "X-WC-Webhook-Resource": "action",
+      "X-WC-Webhook-Event": "woocommerce_add_to_cart",
+      "X-WC-Webhook-Signature": "geC1akFhCtsO7fbXz5XiGUsMsRa4Mt0IJsZ96nTaHjI=",
+      "X-WC-Webhook-ID": 535,
+      "X-WC-Webhook-Delivery-ID": 378
+    },
+    "request_body": "{\"action\":\"woocommerce_add_to_cart\",\"arg\":\"7cbbc409ec990f19c78c75bd1e06f215\"}",
+    "response_code": "200",
+    "response_message": "OK",
+    "response_headers": {
+      "connection": "close",
+      "server": "gunicorn/18.0",
+      "date": "Wed, 21 Jan 2015 16:22:49 GMT",
+      "content-type": "text/html; charset=utf-8",
+      "content-length": "2",
+      "sponsored-by": "https://www.runscope.com",
+      "via": "1.1 vegur"
+    },
+    "response_body": "ok",
+    "created_at": "2015-01-21T16:26:12Z"
+  }
+}
+```
+
+<aside class="notice">
+	View the <a href="#delivery-properties">Delivery Properties</a> for more details on this response.
+</aside>
+
+## View List Of Webhooks Deliveries ##
+
+This API helps you to view all deliveries from a specific webhooks.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v2/webhooks/&lt;id&gt;/deliveries</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v2/webhooks/535/deliveries \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('webhooks/535/deliveries', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("webhooks/535/deliveries").json())
+```
+
+```php
+<?php print_r($woocommerce->webhooks->get_deliveries()); ?>
+```
+
+```ruby
+woocommerce.get("webhooks/535/deliveries").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "webhook_deliveries": [
+    {
+      "id": 380,
+      "duration": "0.58635",
+      "summary": "HTTP 200 OK: ok",
+      "request_method": "POST",
+      "request_url": "http://requestb.in/125q7ns1",
+      "request_headers": {
+        "User-Agent": "WooCommerce/2.3.0 Hookshot (WordPress/4.1)",
+        "Content-Type": "application/json",
+        "X-WC-Webhook-Topic": "action.woocommerce_add_to_cart",
+        "X-WC-Webhook-Resource": "action",
+        "X-WC-Webhook-Event": "woocommerce_add_to_cart",
+        "X-WC-Webhook-Signature": "st4egVCTwG1JMfxmxe7MZYEuj9Y6Euge4SOTNfCUCWY=",
+        "X-WC-Webhook-ID": 535,
+        "X-WC-Webhook-Delivery-ID": 380
+      },
+      "request_body": "{\"action\":\"woocommerce_add_to_cart\",\"arg\":\"c16a5320fa475530d9583c34fd356ef5\"}",
+      "response_code": "200",
+      "response_message": "OK",
+      "response_headers": {
+        "connection": "close",
+        "server": "gunicorn/18.0",
+        "date": "Wed, 21 Jan 2015 16:23:05 GMT",
+        "content-type": "text/html; charset=utf-8",
+        "content-length": "2",
+        "sponsored-by": "https://www.runscope.com",
+        "via": "1.1 vegur"
+      },
+      "response_body": "ok",
+      "created_at": "2015-01-21T16:26:28Z"
+    },
+    {
+      "id": 378,
+      "duration": "0.90226",
+      "summary": "HTTP 200 OK: ok",
+      "request_method": "POST",
+      "request_url": "http://requestb.in/125q7ns1",
+      "request_headers": {
+        "User-Agent": "WooCommerce/2.3.0 Hookshot (WordPress/4.1)",
+        "Content-Type": "application/json",
+        "X-WC-Webhook-Topic": "action.woocommerce_add_to_cart",
+        "X-WC-Webhook-Resource": "action",
+        "X-WC-Webhook-Event": "woocommerce_add_to_cart",
+        "X-WC-Webhook-Signature": "geC1akFhCtsO7fbXz5XiGUsMsRa4Mt0IJsZ96nTaHjI=",
+        "X-WC-Webhook-ID": 535,
+        "X-WC-Webhook-Delivery-ID": 378
+      },
+      "request_body": "{\"action\":\"woocommerce_add_to_cart\",\"arg\":\"7cbbc409ec990f19c78c75bd1e06f215\"}",
+      "response_code": "200",
+      "response_message": "OK",
+      "response_headers": {
+        "connection": "close",
+        "server": "gunicorn/18.0",
+        "date": "Wed, 21 Jan 2015 16:22:49 GMT",
+        "content-type": "text/html; charset=utf-8",
+        "content-length": "2",
+        "sponsored-by": "https://www.runscope.com",
+        "via": "1.1 vegur"
+      },
+      "response_body": "ok",
+      "created_at": "2015-01-21T16:26:12Z"
+    }
+  ]
+}
+```
diff --git a/source/index.md b/source/index.md
index 2ee823e0..b83512e1 100644
--- a/source/index.md
+++ b/source/index.md
@@ -1,5 +1,5 @@
 ---
-title: WooCommerce REST API Documentation v2
+title: WooCommerce REST API Documentation v3
 
 language_tabs:
   - shell: cURL
@@ -18,14 +18,14 @@ toc_footers:
   - <div class="github-buttons"><iframe src="https://ghbtns.com/github-btn.html?user=woothemes&amp;repo=woocommerce&amp;type=star&amp;count=true" allowtransparency="true" frameborder="0" scrolling="0" width="170px" height="20px"></iframe> <iframe src="https://ghbtns.com/github-btn.html?user=woothemes&amp;repo=woocommerce&amp;type=fork&amp;count=true" allowtransparency="true" frameborder="0" scrolling="0" width="170px" height="20px"></iframe></div>
 
 includes:
-  - v2/introduction
-  - v2/index
-  - v2/coupons
-  - v2/customers
-  - v2/orders
-  - v2/products
-  - v2/reports
-  - v2/webhooks
+  - v3/introduction
+  - v3/index
+  - v3/coupons
+  - v3/customers
+  - v3/orders
+  - v3/products
+  - v3/reports
+  - v3/webhooks
 
 search: true
 ---
diff --git a/source/v2.md b/source/v2.md
new file mode 100644
index 00000000..2ee823e0
--- /dev/null
+++ b/source/v2.md
@@ -0,0 +1,31 @@
+---
+title: WooCommerce REST API Documentation v2
+
+language_tabs:
+  - shell: cURL
+  - javascript: Node.js
+  - python: Python
+  - php: PHP
+  - ruby: Ruby
+
+toc_footers:
+  - <a href="https://github.com/woothemes/woocommerce-rest-api-docs">Contributing to WC REST API Docs</a>
+  - <a href="https://github.com/woothemes/woocommerce/tree/master/includes/api">REST API Source on GitHub</a>
+  - <a href="https://github.com/woothemes/woocommerce/issues?labels=API&amp;page=1&amp;state=open">REST API Issues</a>
+  - <a href="http://docs.woothemes.com/documentation/plugins/woocommerce/">WooCommerce Documentation</a>
+  - <a href="https://github.com/woothemes/woocommerce">WooCommerce Repository</a>
+  - <a href="http://github.com/tripit/slate">Documentation Powered by Slate</a>
+  - <div class="github-buttons"><iframe src="https://ghbtns.com/github-btn.html?user=woothemes&amp;repo=woocommerce&amp;type=star&amp;count=true" allowtransparency="true" frameborder="0" scrolling="0" width="170px" height="20px"></iframe> <iframe src="https://ghbtns.com/github-btn.html?user=woothemes&amp;repo=woocommerce&amp;type=fork&amp;count=true" allowtransparency="true" frameborder="0" scrolling="0" width="170px" height="20px"></iframe></div>
+
+includes:
+  - v2/introduction
+  - v2/index
+  - v2/coupons
+  - v2/customers
+  - v2/orders
+  - v2/products
+  - v2/reports
+  - v2/webhooks
+
+search: true
+---

From 8c0ebbb5f0432fdc877653c0b90fd454669f6813 Mon Sep 17 00:00:00 2001
From: Claudio Sanches <contato@claudiosmweb.com>
Date: Fri, 31 Jul 2015 21:31:34 -0300
Subject: [PATCH 02/18] Updated index for both versions and update introduction
 for v3

---
 source/includes/v2/_index.md        | 729 +++++++++++++++-------------
 source/includes/v3/_index.md        | 727 ++++++++++++++-------------
 source/includes/v3/_introduction.md |  18 +-
 3 files changed, 814 insertions(+), 660 deletions(-)

diff --git a/source/includes/v2/_index.md b/source/includes/v2/_index.md
index a2de9460..aa17d2de 100644
--- a/source/includes/v2/_index.md
+++ b/source/includes/v2/_index.md
@@ -30,17 +30,20 @@ The API index provides information about the endpoints available for the site, a
 
 |      Attribute       |   Type  |                                               Description                                                |
 | -------------------- | ------- | -------------------------------------------------------------------------------------------------------- |
-| `timezone`           | string  | The site's timezone                                                                                      |
 | `currency`           | string  | Currency ISO Code, e.g. `GBP`                                                                            |
 | `currency_format`    | string  | Currency symbol, HTML encoded, e.g. `£`                                                                  |
+| `currency_position`  | string  | Currency position, available the following options: `right`, `left`, `right_space` and `left_space`      |
+| `decimal_separator`  | string  | Decimal separator, e.g `,`                                                                               |
+| `dimension_unit`     | string  | The unit set for product dimensions. Valid units are `cm`, `m`, `cm`, `mm`, `in`, and `yd`               |
+| `generate_password`  | boolean | Shows if the API is able to auto generate passwords for new customers                                    |
+| `links`              | array   | API help links list                                                                                      |
+| `permalinks_enabled` | boolean | Whether pretty permalinks are enabled on the site, if this is false, the API will not function correctly |
 | `price_num_decimals` | integer | Number of decimals                                                                                       |
+| `ssl_enabled`        | boolean | True if SSL is enabled for the site, false otherwise                                                     |
 | `tax_included`       | boolean | True if prices include tax, false otherwise                                                              |
+| `thousand_separator` | string  | The unit set for product weights. Valid units are `kg`, `g`, `lbs`, `oz`                                 |
+| `timezone`           | string  | The site's timezone                                                                                      |
 | `weight_unit`        | string  | The unit set for product weights. Valid units are `kg`, `g`, `lbs`, `oz`                                 |
-| `dimension_unit`     | string  | The unit set for product dimensions. Valid units are `cm`, `m`, `cm`, `mm`, `in`, and `yd`               |
-| `ssl_enabled`        | boolean | True if SSL is enabled for the site, false otherwise                                                     |
-| `permalinks_enabled` | boolean | Whether pretty permalinks are enabled on the site, if this is false, the API will not function correctly |
-| `links`              | array   | API help links list                                                                                      |
-
 
 ## View Index List ##
 
@@ -82,328 +85,404 @@ woocommerce.get("").parsed_response
 
 ```json
 {
-  "store": {
-    "name": "WooCommerce",
-    "description": "Just a WooCommerce store",
-    "URL": "http://example.com",
-    "wc_version": "2.3.0",
-    "routes": {
-      "/": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/"
-        }
-      },
-      "/customers": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST"
-        ],
+    "store": {
+        "URL": "http://example.com",
+        "description": "",
         "meta": {
-          "self": "https://example.com/wc-api/v2/customers"
+            "currency": "USD",
+            "currency_format": "&#36;",
+            "currency_position": "left_space",
+            "decimal_separator": ",",
+            "dimension_unit": "in",
+            "generate_password": false,
+            "links": {
+                "help": "http://woothemes.github.io/woocommerce-rest-api-docs/"
+            },
+            "permalinks_enabled": true,
+            "price_num_decimals": 2,
+            "ssl_enabled": true,
+            "tax_included": false,
+            "thousand_separator": ".",
+            "timezone": "America/Sao_Paulo",
+            "weight_unit": "lbs"
         },
-        "accepts_data": true
-      },
-      "/customers/count": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/customers/count"
-        }
-      },
-      "/customers/<id>": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST",
-          "PUT",
-          "PATCH",
-          "DELETE"
-        ],
-        "accepts_data": true
-      },
-      "/customers/email/<email>": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ]
-      },
-      "/customers/<id>/orders": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ]
-      },
-      "/customers/<id>/downloads": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ]
-      },
-      "/orders": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/orders"
+        "name": "WooCommerce Dev",
+        "routes": {
+            "/": {
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/coupons": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/coupons"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST"
+                ]
+            },
+            "/coupons/<id>": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST",
+                    "PUT",
+                    "PATCH",
+                    "DELETE"
+                ]
+            },
+            "/coupons/bulk": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/coupons/bulk"
+                },
+                "supports": [
+                    "POST",
+                    "PUT",
+                    "PATCH"
+                ]
+            },
+            "/coupons/code/<code>": {
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/coupons/count": {
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/coupons/count"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/customers": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/customers"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST"
+                ]
+            },
+            "/customers/<id>": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST",
+                    "PUT",
+                    "PATCH",
+                    "DELETE"
+                ]
+            },
+            "/customers/<id>/downloads": {
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/customers/<id>/orders": {
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/customers/bulk": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/customers/bulk"
+                },
+                "supports": [
+                    "POST",
+                    "PUT",
+                    "PATCH"
+                ]
+            },
+            "/customers/count": {
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/customers/count"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/customers/email/<email>": {
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/orders": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/orders"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST"
+                ]
+            },
+            "/orders/<id>": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST",
+                    "PUT",
+                    "PATCH",
+                    "DELETE"
+                ]
+            },
+            "/orders/<order_id>/notes": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST"
+                ]
+            },
+            "/orders/<order_id>/notes/<id>": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST",
+                    "PUT",
+                    "PATCH",
+                    "DELETE"
+                ]
+            },
+            "/orders/<order_id>/refunds": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST"
+                ]
+            },
+            "/orders/<order_id>/refunds/<id>": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST",
+                    "PUT",
+                    "PATCH",
+                    "DELETE"
+                ]
+            },
+            "/orders/bulk": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/orders/bulk"
+                },
+                "supports": [
+                    "POST",
+                    "PUT",
+                    "PATCH"
+                ]
+            },
+            "/orders/count": {
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/orders/count"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/orders/statuses": {
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/orders/statuses"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/products": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/products"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST"
+                ]
+            },
+            "/products/<id>": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST",
+                    "PUT",
+                    "PATCH",
+                    "DELETE"
+                ]
+            },
+            "/products/<id>/orders": {
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/products/<id>/reviews": {
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/products/attributes": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/products/attributes"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST"
+                ]
+            },
+            "/products/attributes/<id>": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST",
+                    "PUT",
+                    "PATCH",
+                    "DELETE"
+                ]
+            },
+            "/products/bulk": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/products/bulk"
+                },
+                "supports": [
+                    "POST",
+                    "PUT",
+                    "PATCH"
+                ]
+            },
+            "/products/categories": {
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/products/categories"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/products/categories/<id>": {
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/products/count": {
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/products/count"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/products/sku/<sku>": {
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/reports": {
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/reports"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/reports/sales": {
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/reports/sales"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/reports/sales/top_sellers": {
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/reports/sales/top_sellers"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/webhooks": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/webhooks"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST"
+                ]
+            },
+            "/webhooks/<id>": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST",
+                    "PUT",
+                    "PATCH",
+                    "DELETE"
+                ]
+            },
+            "/webhooks/<webhook_id>/deliveries": {
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/webhooks/<webhook_id>/deliveries/<id>": {
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/webhooks/count": {
+                "meta": {
+                    "self": "http://example.com/wc-api/v2/webhooks/count"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            }
         },
-        "accepts_data": true
-      },
-      "/orders/count": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/orders/count"
-        }
-      },
-      "/orders/statuses": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/orders/statuses"
-        }
-      },
-      "/orders/<id>": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST",
-          "PUT",
-          "PATCH",
-          "DELETE"
-        ],
-        "accepts_data": true
-      },
-      "/orders/<order_id>/notes": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST"
-        ],
-        "accepts_data": true
-      },
-      "/orders/<order_id>/notes/<id>": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST",
-          "PUT",
-          "PATCH",
-          "DELETE"
-        ],
-        "accepts_data": true
-      },
-      "/orders/<order_id>/refunds": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST"
-        ],
-        "accepts_data": true
-      },
-      "/orders/<order_id>/refunds/<id>": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST",
-          "PUT",
-          "PATCH",
-          "DELETE"
-        ],
-        "accepts_data": true
-      },
-      "/products": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/products"
-        },
-        "accepts_data": true
-      },
-      "/products/count": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/products/count"
-        }
-      },
-      "/products/<id>": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST",
-          "PUT",
-          "PATCH",
-          "DELETE"
-        ],
-        "accepts_data": true
-      },
-      "/products/<id>/reviews": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ]
-      },
-      "/products/categories": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/products/categories"
-        }
-      },
-      "/products/categories/<id>": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ]
-      },
-      "/products/sku/<sku>": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ]
-      },
-      "/coupons": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/coupons"
-        },
-        "accepts_data": true
-      },
-      "/coupons/count": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/coupons/count"
-        }
-      },
-      "/coupons/<id>": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST",
-          "PUT",
-          "PATCH",
-          "DELETE"
-        ],
-        "accepts_data": true
-      },
-      "/coupons/code/<code>": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ]
-      },
-      "/reports": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/reports"
-        }
-      },
-      "/reports/sales": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/reports/sales"
-        }
-      },
-      "/reports/sales/top_sellers": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/reports/sales/top_sellers"
-        }
-      },
-      "/webhooks": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/webhooks"
-        },
-        "accepts_data": true
-      },
-      "/webhooks/count": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/webhooks/count"
-        }
-      },
-      "/webhooks/<id>": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST",
-          "PUT",
-          "PATCH",
-          "DELETE"
-        ],
-        "accepts_data": true
-      },
-      "/webhooks/<webhook_id>/deliveries": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ]
-      },
-      "/webhooks/<webhook_id>/deliveries/<id>": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ]
-      }
-    },
-    "meta": {
-      "timezone": "America/Sao_Paulo",
-      "currency": "USD",
-      "currency_format": "&#36;",
-      "price_num_decimals": "2",
-      "tax_included": false,
-      "weight_unit": "kg",
-      "dimension_unit": "cm",
-      "ssl_enabled": false,
-      "permalinks_enabled": true,
-      "links": {
-        "help": "http://woothemes.github.io/woocommerce-rest-api-docs/"
-      }
+        "wc_version": "2.3.13"
     }
-  }
 }
 ```
diff --git a/source/includes/v3/_index.md b/source/includes/v3/_index.md
index a2de9460..21dd06bb 100644
--- a/source/includes/v3/_index.md
+++ b/source/includes/v3/_index.md
@@ -30,17 +30,20 @@ The API index provides information about the endpoints available for the site, a
 
 |      Attribute       |   Type  |                                               Description                                                |
 | -------------------- | ------- | -------------------------------------------------------------------------------------------------------- |
-| `timezone`           | string  | The site's timezone                                                                                      |
 | `currency`           | string  | Currency ISO Code, e.g. `GBP`                                                                            |
 | `currency_format`    | string  | Currency symbol, HTML encoded, e.g. `£`                                                                  |
+| `currency_position`  | string  | Currency position, available the following options: `right`, `left`, `right_space` and `left_space`      |
+| `decimal_separator`  | string  | Decimal separator, e.g `,`                                                                               |
+| `dimension_unit`     | string  | The unit set for product dimensions. Valid units are `cm`, `m`, `cm`, `mm`, `in`, and `yd`               |
+| `generate_password`  | boolean | Shows if the API is able to auto generate passwords for new customers                                    |
+| `links`              | array   | API help links list                                                                                      |
+| `permalinks_enabled` | boolean | Whether pretty permalinks are enabled on the site, if this is false, the API will not function correctly |
 | `price_num_decimals` | integer | Number of decimals                                                                                       |
+| `ssl_enabled`        | boolean | True if SSL is enabled for the site, false otherwise                                                     |
 | `tax_included`       | boolean | True if prices include tax, false otherwise                                                              |
+| `thousand_separator` | string  | The unit set for product weights. Valid units are `kg`, `g`, `lbs`, `oz`                                 |
+| `timezone`           | string  | The site's timezone                                                                                      |
 | `weight_unit`        | string  | The unit set for product weights. Valid units are `kg`, `g`, `lbs`, `oz`                                 |
-| `dimension_unit`     | string  | The unit set for product dimensions. Valid units are `cm`, `m`, `cm`, `mm`, `in`, and `yd`               |
-| `ssl_enabled`        | boolean | True if SSL is enabled for the site, false otherwise                                                     |
-| `permalinks_enabled` | boolean | Whether pretty permalinks are enabled on the site, if this is false, the API will not function correctly |
-| `links`              | array   | API help links list                                                                                      |
-
 
 ## View Index List ##
 
@@ -51,12 +54,12 @@ Retrieve a set of store information.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2</h6>
+		<h6>/wc-api/v3</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2 \
+curl https://example.com/wc-api/v3 \
 	-u consumer_key:consumer_secret
 ```
 
@@ -82,328 +85,398 @@ woocommerce.get("").parsed_response
 
 ```json
 {
-  "store": {
-    "name": "WooCommerce",
-    "description": "Just a WooCommerce store",
-    "URL": "http://example.com",
-    "wc_version": "2.3.0",
-    "routes": {
-      "/": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/"
-        }
-      },
-      "/customers": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST"
-        ],
+    "store": {
+        "URL": "https://example.com",
+        "description": "",
         "meta": {
-          "self": "https://example.com/wc-api/v2/customers"
+            "currency": "USD",
+            "currency_format": "&#36;",
+            "currency_position": "left",
+            "decimal_separator": ",",
+            "dimension_unit": "in",
+            "generate_password": false,
+            "links": {
+                "help": "http://woothemes.github.io/woocommerce-rest-api-docs/"
+            },
+            "permalinks_enabled": true,
+            "price_num_decimals": 2,
+            "ssl_enabled": true,
+            "tax_included": true,
+            "thousand_separator": ".",
+            "timezone": "America/Los_Angeles",
+            "weight_unit": "lbs"
         },
-        "accepts_data": true
-      },
-      "/customers/count": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/customers/count"
-        }
-      },
-      "/customers/<id>": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST",
-          "PUT",
-          "PATCH",
-          "DELETE"
-        ],
-        "accepts_data": true
-      },
-      "/customers/email/<email>": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ]
-      },
-      "/customers/<id>/orders": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ]
-      },
-      "/customers/<id>/downloads": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ]
-      },
-      "/orders": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/orders"
+        "name": "WooCommerce Dev",
+        "routes": {
+            "/": {
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/coupons": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/coupons"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST"
+                ]
+            },
+            "/coupons/<id>": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST",
+                    "PUT",
+                    "PATCH",
+                    "DELETE"
+                ]
+            },
+            "/coupons/bulk": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/coupons/bulk"
+                },
+                "supports": [
+                    "POST",
+                    "PUT",
+                    "PATCH"
+                ]
+            },
+            "/coupons/code/<code>": {
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/coupons/count": {
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/coupons/count"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/customers": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/customers"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST"
+                ]
+            },
+            "/customers/<id>": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST",
+                    "PUT",
+                    "PATCH",
+                    "DELETE"
+                ]
+            },
+            "/customers/<id>/downloads": {
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/customers/<id>/orders": {
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/customers/bulk": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/customers/bulk"
+                },
+                "supports": [
+                    "POST",
+                    "PUT",
+                    "PATCH"
+                ]
+            },
+            "/customers/count": {
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/customers/count"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/customers/email/<email>": {
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/orders": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/orders"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST"
+                ]
+            },
+            "/orders/<id>": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST",
+                    "PUT",
+                    "PATCH",
+                    "DELETE"
+                ]
+            },
+            "/orders/<order_id>/notes": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST"
+                ]
+            },
+            "/orders/<order_id>/notes/<id>": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST",
+                    "PUT",
+                    "PATCH",
+                    "DELETE"
+                ]
+            },
+            "/orders/<order_id>/refunds": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST"
+                ]
+            },
+            "/orders/<order_id>/refunds/<id>": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST",
+                    "PUT",
+                    "PATCH",
+                    "DELETE"
+                ]
+            },
+            "/orders/bulk": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/orders/bulk"
+                },
+                "supports": [
+                    "POST",
+                    "PUT",
+                    "PATCH"
+                ]
+            },
+            "/orders/count": {
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/orders/count"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/orders/statuses": {
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/orders/statuses"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/products": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/products"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST"
+                ]
+            },
+            "/products/<id>": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST",
+                    "PUT",
+                    "PATCH",
+                    "DELETE"
+                ]
+            },
+            "/products/<id>/orders": {
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/products/<id>/reviews": {
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/products/attributes": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/products/attributes"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST"
+                ]
+            },
+            "/products/attributes/<id>": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST",
+                    "PUT",
+                    "PATCH",
+                    "DELETE"
+                ]
+            },
+            "/products/bulk": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/products/bulk"
+                },
+                "supports": [
+                    "POST",
+                    "PUT",
+                    "PATCH"
+                ]
+            },
+            "/products/categories": {
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/products/categories"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/products/categories/<id>": {
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/products/count": {
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/products/count"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/reports": {
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/reports"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/reports/sales": {
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/reports/sales"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/reports/sales/top_sellers": {
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/reports/sales/top_sellers"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/webhooks": {
+                "accepts_data": true,
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/webhooks"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST"
+                ]
+            },
+            "/webhooks/<id>": {
+                "accepts_data": true,
+                "supports": [
+                    "HEAD",
+                    "GET",
+                    "POST",
+                    "PUT",
+                    "PATCH",
+                    "DELETE"
+                ]
+            },
+            "/webhooks/<webhook_id>/deliveries": {
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/webhooks/<webhook_id>/deliveries/<id>": {
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            },
+            "/webhooks/count": {
+                "meta": {
+                    "self": "https://example.com/wc-api/v3/webhooks/count"
+                },
+                "supports": [
+                    "HEAD",
+                    "GET"
+                ]
+            }
         },
-        "accepts_data": true
-      },
-      "/orders/count": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/orders/count"
-        }
-      },
-      "/orders/statuses": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/orders/statuses"
-        }
-      },
-      "/orders/<id>": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST",
-          "PUT",
-          "PATCH",
-          "DELETE"
-        ],
-        "accepts_data": true
-      },
-      "/orders/<order_id>/notes": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST"
-        ],
-        "accepts_data": true
-      },
-      "/orders/<order_id>/notes/<id>": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST",
-          "PUT",
-          "PATCH",
-          "DELETE"
-        ],
-        "accepts_data": true
-      },
-      "/orders/<order_id>/refunds": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST"
-        ],
-        "accepts_data": true
-      },
-      "/orders/<order_id>/refunds/<id>": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST",
-          "PUT",
-          "PATCH",
-          "DELETE"
-        ],
-        "accepts_data": true
-      },
-      "/products": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/products"
-        },
-        "accepts_data": true
-      },
-      "/products/count": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/products/count"
-        }
-      },
-      "/products/<id>": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST",
-          "PUT",
-          "PATCH",
-          "DELETE"
-        ],
-        "accepts_data": true
-      },
-      "/products/<id>/reviews": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ]
-      },
-      "/products/categories": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/products/categories"
-        }
-      },
-      "/products/categories/<id>": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ]
-      },
-      "/products/sku/<sku>": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ]
-      },
-      "/coupons": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/coupons"
-        },
-        "accepts_data": true
-      },
-      "/coupons/count": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/coupons/count"
-        }
-      },
-      "/coupons/<id>": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST",
-          "PUT",
-          "PATCH",
-          "DELETE"
-        ],
-        "accepts_data": true
-      },
-      "/coupons/code/<code>": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ]
-      },
-      "/reports": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/reports"
-        }
-      },
-      "/reports/sales": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/reports/sales"
-        }
-      },
-      "/reports/sales/top_sellers": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/reports/sales/top_sellers"
-        }
-      },
-      "/webhooks": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/webhooks"
-        },
-        "accepts_data": true
-      },
-      "/webhooks/count": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ],
-        "meta": {
-          "self": "https://example.com/wc-api/v2/webhooks/count"
-        }
-      },
-      "/webhooks/<id>": {
-        "supports": [
-          "HEAD",
-          "GET",
-          "POST",
-          "PUT",
-          "PATCH",
-          "DELETE"
-        ],
-        "accepts_data": true
-      },
-      "/webhooks/<webhook_id>/deliveries": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ]
-      },
-      "/webhooks/<webhook_id>/deliveries/<id>": {
-        "supports": [
-          "HEAD",
-          "GET"
-        ]
-      }
-    },
-    "meta": {
-      "timezone": "America/Sao_Paulo",
-      "currency": "USD",
-      "currency_format": "&#36;",
-      "price_num_decimals": "2",
-      "tax_included": false,
-      "weight_unit": "kg",
-      "dimension_unit": "cm",
-      "ssl_enabled": false,
-      "permalinks_enabled": true,
-      "links": {
-        "help": "http://woothemes.github.io/woocommerce-rest-api-docs/"
-      }
+        "wc_version": "2.4.0"
     }
-  }
 }
 ```
diff --git a/source/includes/v3/_introduction.md b/source/includes/v3/_introduction.md
index 5bf44cba..1187f2c6 100644
--- a/source/includes/v3/_introduction.md
+++ b/source/includes/v3/_introduction.md
@@ -87,7 +87,7 @@ You may use [HTTP Basic Auth](http://en.wikipedia.org/wiki/Basic_access_authenti
 > HTTP Basic Auth example
 
 ```shell
-curl https://www.example.com/wc-api/v2/orders \
+curl https://www.example.com/wc-api/v3/orders \
     -u consumer_key:consumer_secret
 ```
 
@@ -96,7 +96,7 @@ Occasionally some servers may not properly parse the Authorization header (if yo
 > Example for servers that not properly parse the Authorization header:
 
 ```shell
-curl https://www.example.com/wc-api/v2/orders?consumer_key=123&consumer_secret=abc
+curl https://www.example.com/wc-api/v3/orders?consumer_key=123&consumer_secret=abc
 ```
 
 ### Over HTTP ###
@@ -323,12 +323,12 @@ The API supports JSONP by default. JSONP responses uses the `application/javascr
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/orders/count?_jsonp=ordersCount</h6>
+		<h6>/wc-api/v3/orders/count?_jsonp=ordersCount</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/orders/count?_jsonp=ordersCount \
+curl https://example.com/wc-api/v3/orders/count?_jsonp=ordersCount \
 	-u consumer_key:consumer_secret
 ```
 
@@ -367,6 +367,8 @@ curl https://example.com/wc-api/v2/orders/count?_jsonp=ordersCount \
 
 ## Webhooks ##
 
+@TODO needs update! Now we have an visual endpoint for it!
+
 Webhooks are an experimental feature in the v2 REST API. They must be managed using the REST API endpoints as a UI is not yet available. The `WC_Webhook` class manages all data storage/retrieval from the custom post type, as well as enqueuing a webhook's actions and processing/delivering/logging the webhook. On `woocommerce_init`, active webhooks are loaded and their associated hooks are added.
 
 Each webhook has:
@@ -443,7 +445,7 @@ var WooCommerce = new WooCommerceAPI({
   url: 'http://example.com', // Your store URL
   consumerKey: 'consumer_key', // Your consumer key
   consumerSecret: 'consumer_secret', // Your consumer secret
-  version: 'v2' // WooCommerce API version
+  version: 'v3' // WooCommerce API version
 });
 ```
 
@@ -458,14 +460,14 @@ wcapi = API(
     url="http://example.com",
     consumer_key="consumer_key",
     consumer_secret="consumer_secret",
-    version="v2"
+    version="v3"
 )
 ```
 
 ```php
 <?php
 // Install:
-// composer require "woothemes/woocommerce-api:2.*"
+// composer require "woothemes/woocommerce-api:3.*"
 
 // Setup:
 include_once('vendor/autoload.php');
@@ -490,7 +492,7 @@ woocommerce = WooCommerce::API.new(
   "consumer_key",
   "consumer_secret",
   {
-    version: "v2"
+    version: "v3"
   }
 )
 ```

From 25d4a6c87bf239a35c4a61dc50ff03c5babde3a3 Mon Sep 17 00:00:00 2001
From: Claudio Sanches <contato@claudiosmweb.com>
Date: Fri, 31 Jul 2015 21:33:52 -0300
Subject: [PATCH 03/18] Updated examples of coupons for v3

---
 source/includes/v3/_coupons.md | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/source/includes/v3/_coupons.md b/source/includes/v3/_coupons.md
index c86e88f7..1158ed4e 100644
--- a/source/includes/v3/_coupons.md
+++ b/source/includes/v3/_coupons.md
@@ -38,12 +38,12 @@ This API helps you to create a new coupon.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-post">POST</i>
-		<h6>/wc-api/v2/coupons</h6>
+		<h6>/wc-api/v3/coupons</h6>
 	</div>
 </div>
 
 ```shell
-curl -X POST https://example.com/wc-api/v2/coupons \
+curl -X POST https://example.com/wc-api/v3/coupons \
 	-u consumer_key:consumer_secret \
 	-H "Content-Type: application/json" \
 	-d '{
@@ -222,19 +222,19 @@ This API lets you retrieve and view a specific coupon by ID or code.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/coupons/&lt;id&gt;</h6>
+		<h6>/wc-api/v3/coupons/&lt;id&gt;</h6>
 	</div>
 </div>
 
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/coupons/code/&lt;code&gt;</h6>
+		<h6>/wc-api/v3/coupons/code/&lt;code&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/coupons/529 \
+curl https://example.com/wc-api/v3/coupons/529 \
 	-u consumer_key:consumer_secret
 ```
 
@@ -296,12 +296,12 @@ This API helps you to view all the coupons.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/coupons</h6>
+		<h6>/wc-api/v3/coupons</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/coupons \
+curl https://example.com/wc-api/v3/coupons \
 	-u consumer_key:consumer_secret
 ```
 
@@ -413,12 +413,12 @@ This API lets you make changes to a coupon.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-put">PUT</i>
-		<h6>/wc-api/v2/coupons/&lt;id&gt;</h6>
+		<h6>/wc-api/v3/coupons/&lt;id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl -X PUT https://example.com/wc-api/v2/coupons/529 \
+curl -X PUT https://example.com/wc-api/v3/coupons/529 \
 	-u consumer_key:consumer_secret \
 	-H "Content-Type: application/json" \
 	-d '{
@@ -512,12 +512,12 @@ This API helps you delete a coupon.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-delete">DELETE</i>
-		<h6>/wc-api/v2/coupons/&lt;id&gt;</h6>
+		<h6>/wc-api/v3/coupons/&lt;id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl -X DELETE https://example.com/wc-api/v2/coupons/529/?force=true \
+curl -X DELETE https://example.com/wc-api/v3/coupons/529/?force=true \
 	-u consumer_key:consumer_secret
 ```
 
@@ -562,12 +562,12 @@ This API lets you retrieve a count of all coupons.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/coupons/count</h6>
+		<h6>/wc-api/v3/coupons/count</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/coupons/count \
+curl https://example.com/wc-api/v3/coupons/count \
 	-u consumer_key:consumer_secret
 ```
 

From b6239cb4d72e244933cdae045c7ebcbfbd949ddf Mon Sep 17 00:00:00 2001
From: Claudio Sanches <contato@claudiosmweb.com>
Date: Fri, 31 Jul 2015 21:35:23 -0300
Subject: [PATCH 04/18] Updated examples of customers for v3

---
 source/includes/v3/_customers.md | 34 ++++++++++++++++----------------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/source/includes/v3/_customers.md b/source/includes/v3/_customers.md
index 797a110d..e441a065 100644
--- a/source/includes/v3/_customers.md
+++ b/source/includes/v3/_customers.md
@@ -60,12 +60,12 @@ This API helps you to create a new customer.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-post">POST</i>
-		<h6>/wc-api/v2/customers</h6>
+		<h6>/wc-api/v3/customers</h6>
 	</div>
 </div>
 
 ```shell
-curl -X POST https://example.com/wc-api/v2/customers \
+curl -X POST https://example.com/wc-api/v3/customers \
 	-u consumer_key:consumer_secret \
 	-H "Content-Type: application/json" \
 	-d '{
@@ -307,19 +307,19 @@ This API lets you retrieve and view a specific customer by ID or email.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/customers/&lt;id&gt;</h6>
+		<h6>/wc-api/v3/customers/&lt;id&gt;</h6>
 	</div>
 </div>
 
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/customers/email/&lt;email&gt;</h6>
+		<h6>/wc-api/v3/customers/email/&lt;email&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/customers/2 \
+curl https://example.com/wc-api/v3/customers/2 \
 	-u consumer_key:consumer_secret
 ```
 
@@ -394,12 +394,12 @@ This API helps you to view all the customers.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/customers</h6>
+		<h6>/wc-api/v3/customers</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/customers \
+curl https://example.com/wc-api/v3/customers \
 	-u consumer_key:consumer_secret
 ```
 
@@ -519,12 +519,12 @@ This API lets you make changes to a customer.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-put">PUT</i>
-		<h6>/wc-api/v2/customers/&lt;id&gt;</h6>
+		<h6>/wc-api/v3/customers/&lt;id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl -X PUT https://example.com/wc-api/v2/customers/2 \
+curl -X PUT https://example.com/wc-api/v3/customers/2 \
 	-u consumer_key:consumer_secret \
 	-H "Content-Type: application/json" \
 	-d '{
@@ -661,12 +661,12 @@ This API helps you delete a customer.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-delete">DELETE</i>
-		<h6>/wc-api/v2/customers/&lt;id&gt;</h6>
+		<h6>/wc-api/v3/customers/&lt;id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl -X DELETE https://example.com/wc-api/v2/customers/2 \
+curl -X DELETE https://example.com/wc-api/v3/customers/2 \
 	-u consumer_key:consumer_secret
 ```
 
@@ -705,12 +705,12 @@ This API lets you retrieve the customers orders.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/customers/&lt;id&gt;/orders</h6>
+		<h6>/wc-api/v3/customers/&lt;id&gt;/orders</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/customers/2/orders \
+curl https://example.com/wc-api/v3/customers/2/orders \
 	-u consumer_key:consumer_secret
 ```
 
@@ -870,12 +870,12 @@ This API lets you retrieve the customers downloads.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/customers/&lt;id&gt;/downloads</h6>
+		<h6>/wc-api/v3/customers/&lt;id&gt;/downloads</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/customers/2/downloads \
+curl https://example.com/wc-api/v3/customers/2/downloads \
 	-u consumer_key:consumer_secret
 ```
 
@@ -943,12 +943,12 @@ This API lets you retrieve a count of all customers.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/customers/count</h6>
+		<h6>/wc-api/v3/customers/count</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/customers/count \
+curl https://example.com/wc-api/v3/customers/count \
 	-u consumer_key:consumer_secret
 ```
 

From 325da5ff0dcc89c4fdf56dd57b7b3892034a8212 Mon Sep 17 00:00:00 2001
From: Claudio Sanches <contato@claudiosmweb.com>
Date: Fri, 31 Jul 2015 21:37:01 -0300
Subject: [PATCH 05/18] Updated examples for v3

---
 source/includes/v3/_orders.md   | 68 ++++++++++++++++-----------------
 source/includes/v3/_products.md | 40 +++++++++----------
 source/includes/v3/_reports.md  | 12 +++---
 source/includes/v3/_webhooks.md | 32 ++++++++--------
 4 files changed, 76 insertions(+), 76 deletions(-)

diff --git a/source/includes/v3/_orders.md b/source/includes/v3/_orders.md
index a76dbcbf..9db97a4b 100644
--- a/source/includes/v3/_orders.md
+++ b/source/includes/v3/_orders.md
@@ -120,14 +120,14 @@ This API helps you to create a new order.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-post">POST</i>
-		<h6>/wc-api/v2/orders</h6>
+		<h6>/wc-api/v3/orders</h6>
 	</div>
 </div>
 
 > Example of create a paid order:
 
 ```shell
-curl -X POST https://example.com/wc-api/v2/orders \
+curl -X POST https://example.com/wc-api/v3/orders \
 	-u consumer_key:consumer_secret \
 	-H "Content-Type: application/json" \
 	-d '{
@@ -585,12 +585,12 @@ This API lets you retrieve and view a specific order.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/orders/&lt;id&gt;</h6>
+		<h6>/wc-api/v3/orders/&lt;id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/orders/645 \
+curl https://example.com/wc-api/v3/orders/645 \
 	-u consumer_key:consumer_secret
 ```
 
@@ -781,12 +781,12 @@ This API helps you to view all the orders.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/orders</h6>
+		<h6>/wc-api/v3/orders</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/orders \
+curl https://example.com/wc-api/v3/orders \
 	-u consumer_key:consumer_secret
 ```
 
@@ -1132,12 +1132,12 @@ This API lets you make changes to an order.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-put">PUT</i>
-		<h6>/wc-api/v2/orders/&lt;id&gt;</h6>
+		<h6>/wc-api/v3/orders/&lt;id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl -X PUT https://example.com/wc-api/v2/orders/645 \
+curl -X PUT https://example.com/wc-api/v3/orders/645 \
 	-u consumer_key:consumer_secret \
 	-H "Content-Type: application/json" \
 	-d '{
@@ -1360,12 +1360,12 @@ This API helps you delete an order.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-delete">DELETE</i>
-		<h6>/wc-api/v2/orders/&lt;id&gt;</h6>
+		<h6>/wc-api/v3/orders/&lt;id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl -X DELETE https://example.com/wc-api/v2/orders/645/?force=true \
+curl -X DELETE https://example.com/wc-api/v3/orders/645/?force=true \
 	-u consumer_key:consumer_secret
 ```
 
@@ -1410,12 +1410,12 @@ This API lets you retrieve a count of all orders.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/orders/count</h6>
+		<h6>/wc-api/v3/orders/count</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/orders/count \
+curl https://example.com/wc-api/v3/orders/count \
 	-u consumer_key:consumer_secret
 ```
 
@@ -1460,12 +1460,12 @@ This API lets you retrieve a list of orders statuses available.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/orders/statuses</h6>
+		<h6>/wc-api/v3/orders/statuses</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/orders/statuses \
+curl https://example.com/wc-api/v3/orders/statuses \
 	-u consumer_key:consumer_secret
 ```
 
@@ -1512,12 +1512,12 @@ This API helps you to create a new note for an order.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-post">POST</i>
-		<h6>/wc-api/v2/orders/&lt;id&gt;/notes</h6>
+		<h6>/wc-api/v3/orders/&lt;id&gt;/notes</h6>
 	</div>
 </div>
 
 ```shell
-curl -X POST https://example.com/wc-api/v2/orders/645/notes \
+curl -X POST https://example.com/wc-api/v3/orders/645/notes \
 	-u consumer_key:consumer_secret \
 	-H "Content-Type: application/json" \
 	-d '{
@@ -1602,12 +1602,12 @@ This API lets you retrieve and view a specific note from an order.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/orders/&lt;id&gt;/notes/&lt;note_id&gt;</h6>
+		<h6>/wc-api/v3/orders/&lt;id&gt;/notes/&lt;note_id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/orders/645/notes/416 \
+curl https://example.com/wc-api/v3/orders/645/notes/416 \
 	-u consumer_key:consumer_secret
 ```
 
@@ -1655,12 +1655,12 @@ This API helps you to view all the notes from an order.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/orders/&lt;id&gt;/notes</h6>
+		<h6>/wc-api/v3/orders/&lt;id&gt;/notes</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/orders/645/notes \
+curl https://example.com/wc-api/v3/orders/645/notes \
 	-u consumer_key:consumer_secret
 ```
 
@@ -1728,12 +1728,12 @@ This API lets you make changes to an order note.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-put">PUT</i>
-		<h6>/wc-api/v2/orders/&lt;id&gt;/notes/&lt;note_id&gt;</h6>
+		<h6>/wc-api/v3/orders/&lt;id&gt;/notes/&lt;note_id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl -X PUT https://example.com/wc-api/v2/orders/645/notes/416 \
+curl -X PUT https://example.com/wc-api/v3/orders/645/notes/416 \
 	-u consumer_key:consumer_secret \
 	-H "Content-Type: application/json" \
 	-d '{
@@ -1813,12 +1813,12 @@ This API helps you delete an order note.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-delete">DELETE</i>
-		<h6>/wc-api/v2/orders/&lt;id&gt;/notes/&lt;note_id&gt;</h6>
+		<h6>/wc-api/v3/orders/&lt;id&gt;/notes/&lt;note_id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl -X DELETE https://example.com/wc-api/v2/orders/645/notes/416 \
+curl -X DELETE https://example.com/wc-api/v3/orders/645/notes/416 \
 	-u consumer_key:consumer_secret
 ```
 
@@ -1857,12 +1857,12 @@ This API helps you to create a new refund for an order.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-post">POST</i>
-		<h6>/wc-api/v2/orders/&lt;id&gt;/refunds</h6>
+		<h6>/wc-api/v3/orders/&lt;id&gt;/refunds</h6>
 	</div>
 </div>
 
 ```shell
-curl -X POST https://example.com/wc-api/v2/orders/645/refunds \
+curl -X POST https://example.com/wc-api/v3/orders/645/refunds \
 	-u consumer_key:consumer_secret \
 	-H "Content-Type: application/json" \
 	-d '{
@@ -1949,12 +1949,12 @@ This API lets you retrieve and view a specific refund from an order.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/orders/&lt;id&gt;/refunds/&lt;refund_id&gt;</h6>
+		<h6>/wc-api/v3/orders/&lt;id&gt;/refunds/&lt;refund_id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/orders/645/refunds/649 \
+curl https://example.com/wc-api/v3/orders/645/refunds/649 \
 	-u consumer_key:consumer_secret
 ```
 
@@ -2003,12 +2003,12 @@ This API helps you to view all the refunds from an order.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/orders/&lt;id&gt;/refunds</h6>
+		<h6>/wc-api/v3/orders/&lt;id&gt;/refunds</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/orders/645/refunds \
+curl https://example.com/wc-api/v3/orders/645/refunds \
 	-u consumer_key:consumer_secret
 ```
 
@@ -2095,12 +2095,12 @@ This API lets you make changes to an order refund.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-put">PUT</i>
-		<h6>/wc-api/v2/orders/&lt;id&gt;/refunds/&lt;refund_id&gt;</h6>
+		<h6>/wc-api/v3/orders/&lt;id&gt;/refunds/&lt;refund_id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl -X PUT https://example.com/wc-api/v2/orders/645/refunds/649 \
+curl -X PUT https://example.com/wc-api/v3/orders/645/refunds/649 \
 	-u consumer_key:consumer_secret \
 	-H "Content-Type: application/json" \
 	-d '{
@@ -2181,12 +2181,12 @@ This API helps you delete an order refund.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-delete">DELETE</i>
-		<h6>/wc-api/v2/orders/&lt;id&gt;/refunds/&lt;refund_id&gt;</h6>
+		<h6>/wc-api/v3/orders/&lt;id&gt;/refunds/&lt;refund_id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl -X DELETE https://example.com/wc-api/v2/orders/645/refunds/649 \
+curl -X DELETE https://example.com/wc-api/v3/orders/645/refunds/649 \
 	-u consumer_key:consumer_secret
 ```
 
diff --git a/source/includes/v3/_products.md b/source/includes/v3/_products.md
index 8677c882..17e05c79 100644
--- a/source/includes/v3/_products.md
+++ b/source/includes/v3/_products.md
@@ -164,14 +164,14 @@ This API helps you to create a new product.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-post">POST</i>
-		<h6>/wc-api/v2/products</h6>
+		<h6>/wc-api/v3/products</h6>
 	</div>
 </div>
 
 > Example of how to create a `simple` product:
 
 ```shell
-curl -X POST https://example.com/wc-api/v2/products \
+curl -X POST https://example.com/wc-api/v3/products \
 	-u consumer_key:consumer_secret \
 	-H "Content-Type: application/json" \
 	-d '{
@@ -416,7 +416,7 @@ woocommerce.post("products", data).parsed_response
 > Example of how to create a `variable` product:
 
 ```shell
-curl -X POST https://example.com/wc-api/v2/products \
+curl -X POST https://example.com/wc-api/v3/products \
 	-u consumer_key:consumer_secret \
 	-H "Content-Type: application/json" \
 	-d '{
@@ -1107,19 +1107,19 @@ This API lets you retrieve and view a specific product by ID or sku.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/products/&lt;id&gt;</h6>
+		<h6>/wc-api/v3/products/&lt;id&gt;</h6>
 	</div>
 </div>
 
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/products/sku/&lt;sku&gt;</h6>
+		<h6>/wc-api/v3/products/sku/&lt;sku&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/products/546 \
+curl https://example.com/wc-api/v3/products/546 \
 	-u consumer_key:consumer_secret
 ```
 
@@ -1248,12 +1248,12 @@ This API helps you to view all the products.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/products</h6>
+		<h6>/wc-api/v3/products</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/products \
+curl https://example.com/wc-api/v3/products \
 	-u consumer_key:consumer_secret
 ```
 
@@ -1618,12 +1618,12 @@ This API lets you make changes to a product.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-put">PUT</i>
-		<h6>/wc-api/v2/products/&lt;id&gt;</h6>
+		<h6>/wc-api/v3/products/&lt;id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl -X PUT https://example.com/wc-api/v2/products/546 \
+curl -X PUT https://example.com/wc-api/v3/products/546 \
 	-u consumer_key:consumer_secret \
 	-H "Content-Type: application/json" \
 	-d '{
@@ -1784,12 +1784,12 @@ This API helps you delete a product.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-delete">DELETE</i>
-		<h6>/wc-api/v2/products/&lt;id&gt;</h6>
+		<h6>/wc-api/v3/products/&lt;id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl -X DELETE https://example.com/wc-api/v2/products/546/?force=true \
+curl -X DELETE https://example.com/wc-api/v3/products/546/?force=true \
 	-u consumer_key:consumer_secret
 ```
 
@@ -1834,12 +1834,12 @@ This API lets you retrieve a count of all products.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/products/count</h6>
+		<h6>/wc-api/v3/products/count</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/products/count \
+curl https://example.com/wc-api/v3/products/count \
 	-u consumer_key:consumer_secret
 ```
 
@@ -1881,12 +1881,12 @@ woocommerce.get("products/count").parsed_response
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/products/&lt;id&gt;/reviews</h6>
+		<h6>/wc-api/v3/products/&lt;id&gt;/reviews</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/products/546/reviews \
+curl https://example.com/wc-api/v3/products/546/reviews \
 	-u consumer_key:consumer_secret
 ```
 
@@ -1951,12 +1951,12 @@ woocommerce.get("products/546/reviews").parsed_response
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/products/categories/&lt;id&gt;</h6>
+		<h6>/wc-api/v3/products/categories/&lt;id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/products/categories/9 \
+curl https://example.com/wc-api/v3/products/categories/9 \
 	-u consumer_key:consumer_secret
 ```
 
@@ -2009,12 +2009,12 @@ woocommerce.get("products/categories/9").parsed_response
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/products/categories</h6>
+		<h6>/wc-api/v3/products/categories</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/products/categories \
+curl https://example.com/wc-api/v3/products/categories \
 	-u consumer_key:consumer_secret
 ```
 
diff --git a/source/includes/v3/_reports.md b/source/includes/v3/_reports.md
index 5500b340..c6f64975 100644
--- a/source/includes/v3/_reports.md
+++ b/source/includes/v3/_reports.md
@@ -21,12 +21,12 @@ This API lets you retrieve and view a simple list of available reports.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/reports</h6>
+		<h6>/wc-api/v3/reports</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/reports \
+curl https://example.com/wc-api/v3/reports \
 	-u consumer_key:consumer_secret
 ```
 
@@ -68,12 +68,12 @@ This API lets you retrieve and view a list of sales report.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/reports/sales</h6>
+		<h6>/wc-api/v3/reports/sales</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/reports/sales?filter[date_min]=2015-01-18&filter[date_max]=2015-01-21 \
+curl https://example.com/wc-api/v3/reports/sales?filter[date_min]=2015-01-18&filter[date_max]=2015-01-21 \
 	-u consumer_key:consumer_secret
 ```
 
@@ -169,12 +169,12 @@ This API lets you retrieve and view a list of top sellers report.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/reports/sales/top_sellers</h6>
+		<h6>/wc-api/v3/reports/sales/top_sellers</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/reports/sales/top_sellers?filter[period]=last_month \
+curl https://example.com/wc-api/v3/reports/sales/top_sellers?filter[period]=last_month \
 	-u consumer_key:consumer_secret
 ```
 
diff --git a/source/includes/v3/_webhooks.md b/source/includes/v3/_webhooks.md
index 145969b9..e478bc0a 100644
--- a/source/includes/v3/_webhooks.md
+++ b/source/includes/v3/_webhooks.md
@@ -57,12 +57,12 @@ This API helps you to create a new webhook.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-post">POST</i>
-		<h6>/wc-api/v2/webhooks</h6>
+		<h6>/wc-api/v3/webhooks</h6>
 	</div>
 </div>
 
 ```shell
-curl -X POST https://example.com/wc-api/v2/webhooks \
+curl -X POST https://example.com/wc-api/v3/webhooks \
 	-u consumer_key:consumer_secret \
 	-H "Content-Type: application/json" \
 	-d '{
@@ -161,12 +161,12 @@ This API lets you retrieve and view a specific webhook.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/webhooks/&lt;id&gt;</h6>
+		<h6>/wc-api/v3/webhooks/&lt;id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/webhooks/535 \
+curl https://example.com/wc-api/v3/webhooks/535 \
 	-u consumer_key:consumer_secret
 ```
 
@@ -218,12 +218,12 @@ This API helps you to view all the webhooks.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/webhooks</h6>
+		<h6>/wc-api/v3/webhooks</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/webhooks \
+curl https://example.com/wc-api/v3/webhooks \
 	-u consumer_key:consumer_secret
 ```
 
@@ -299,12 +299,12 @@ This API lets you make changes to a webhook.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-put">PUT</i>
-		<h6>/wc-api/v2/webhook/&lt;id&gt;</h6>
+		<h6>/wc-api/v3/webhook/&lt;id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl -X PUT https://example.com/wc-api/v2/webhook/535 \
+curl -X PUT https://example.com/wc-api/v3/webhook/535 \
 	-u consumer_key:consumer_secret \
 	-H "Content-Type: application/json" \
 	-d '{
@@ -388,12 +388,12 @@ This API helps you delete a webhook.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-delete">DELETE</i>
-		<h6>/wc-api/v2/webhooks/&lt;id&gt;</h6>
+		<h6>/wc-api/v3/webhooks/&lt;id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl -X DELETE https://example.com/wc-api/v2/webhooks/535 \
+curl -X DELETE https://example.com/wc-api/v3/webhooks/535 \
 	-u consumer_key:consumer_secret
 ```
 
@@ -432,12 +432,12 @@ This API lets you retrieve a count of all webhooks.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/webhooks/count</h6>
+		<h6>/wc-api/v3/webhooks/count</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/webhooks/count \
+curl https://example.com/wc-api/v3/webhooks/count \
 	-u consumer_key:consumer_secret
 ```
 
@@ -482,12 +482,12 @@ This API lets you retrieve and view a specific webhook delivery.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/webhooks/&lt;id&gt;/deliveries/&lt;delivery_id&gt;</h6>
+		<h6>/wc-api/v3/webhooks/&lt;id&gt;/deliveries/&lt;delivery_id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/webhooks/535/deliveries/378 \
+curl https://example.com/wc-api/v3/webhooks/535/deliveries/378 \
 	-u consumer_key:consumer_secret
 ```
 
@@ -560,12 +560,12 @@ This API helps you to view all deliveries from a specific webhooks.
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/webhooks/&lt;id&gt;/deliveries</h6>
+		<h6>/wc-api/v3/webhooks/&lt;id&gt;/deliveries</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/webhooks/535/deliveries \
+curl https://example.com/wc-api/v3/webhooks/535/deliveries \
 	-u consumer_key:consumer_secret
 ```
 

From 88c99721488012c357fbbbfe5a29dc9e39cc9b67 Mon Sep 17 00:00:00 2001
From: Claudio Sanches <contato@claudiosmweb.com>
Date: Fri, 31 Jul 2015 22:31:44 -0300
Subject: [PATCH 06/18] Updated .editorconfig and .gitignore to help with tests

---
 .editorconfig | 12 +++++++-----
 .gitignore    |  2 ++
 2 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/.editorconfig b/.editorconfig
index d1a8f3a1..214ee3f6 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -16,13 +16,15 @@ trim_trailing_whitespace = false
 [*.txt]
 trim_trailing_whitespace = false
 
-[*.json]
-insert_final_newline = false
+[*.{rb,scss,json}]
 indent_size = 2
 tab_width = 2
 indent_style = space
 
-[*.scss]
-indent_size = 2
-tab_width = 2
+[*.json]
+insert_final_newline = false
+
+[*.py]
+indent_size = 4
+tab_width = 4
 indent_style = space
diff --git a/.gitignore b/.gitignore
index 0c79335f..5f2bd03f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -20,3 +20,5 @@ build/
 _yardoc
 doc/
 .idea/
+
+test.*

From 88abf3f514060ff6fb937b67272ea4a79424ffdd Mon Sep 17 00:00:00 2001
From: Claudio Sanches <contato@claudiosmweb.com>
Date: Fri, 31 Jul 2015 22:32:22 -0300
Subject: [PATCH 07/18] Created bulk endpoint docs for coupons, customers,
 orders and products

---
 source/includes/v3/_coupons.md   | 189 ++++++++++++-
 source/includes/v3/_customers.md | 381 ++++++++++++++++++++++++++
 source/includes/v3/_orders.md    | 399 +++++++++++++++++++++++++++
 source/includes/v3/_products.md  | 452 +++++++++++++++++++++++++++++++
 4 files changed, 1420 insertions(+), 1 deletion(-)

diff --git a/source/includes/v3/_coupons.md b/source/includes/v3/_coupons.md
index 1158ed4e..cf305adb 100644
--- a/source/includes/v3/_coupons.md
+++ b/source/includes/v3/_coupons.md
@@ -463,7 +463,7 @@ print_r($woocommerce->coupons->update(529, $data));
 ```
 
 ```ruby
-data {
+data = {
   coupon: {
     amount: "5"
   }
@@ -503,6 +503,193 @@ woocommerce.put("coupons/529", data).parsed_response
 }
 ```
 
+## Create/Update Multiple Coupons ##
+
+This API helps you to bulk create/update multiple coupons.
+
+To update is necessary to send objects containing IDs and to create new not just send the ID.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-post">POST</i>
+		<h6>/wc-api/v3/coupons/bulk</h6>
+	</div>
+</div>
+
+```shell
+curl -X PUT https://example.com/wc-api/v3/coupons/bulk \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "coupons": [
+    {
+      "id": 529,
+      "amount": "15.00"
+    },
+    {
+      "id": 527,
+      "minimum_amount": "55.00"
+    },
+    {
+      "id": 526,
+      "amount": "20.00"
+    }
+  ]
+}'
+```
+
+```javascript
+var data = {
+  coupons: [
+    {
+      id: 529,
+      amount: "15.00"
+    },
+    {
+      id: 527,
+      minimum_amount: "55.00"
+    },
+    {
+      id: 526,
+      amount: "20.00"
+    }
+  ]
+};
+
+WooCommerce.put('coupons/bulk', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "coupons": [
+        {
+            "id": 529,
+            "amount": "15.00"
+        },
+        {
+            "id": 527,
+            "minimum_amount": "55.00"
+        },
+        {
+            "id": 526,
+            "amount": "20.00"
+        }
+    ]
+}
+
+print(wcapi.put("coupons/bulk", data).json())
+```
+
+```php
+
+```
+
+```ruby
+data = {
+  coupons: [
+    {
+      id: 529,
+      amount: "15.00"
+    },
+    {
+      id: 527,
+      minimum_amount: "55.00"
+    },
+    {
+      id: 526,
+      amount: "20.00"
+    }
+  ]
+}
+
+woocommerce.put("coupons/bulk", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "coupons": [
+    {
+      "id": 529,
+      "code": "new-coupon",
+      "type": "percent",
+      "created_at": "2015-01-20T19:05:27Z",
+      "updated_at": "2015-07-31T12:10:33Z",
+      "amount": "15.00",
+      "individual_use": true,
+      "product_ids": [],
+      "exclude_product_ids": [],
+      "usage_limit": null,
+      "usage_limit_per_user": null,
+      "limit_usage_to_x_items": 0,
+      "usage_count": 0,
+      "expiry_date": null,
+      "enable_free_shipping": false,
+      "product_category_ids": [],
+      "exclude_product_category_ids": [],
+      "exclude_sale_items": true,
+      "minimum_amount": "100.00",
+      "maximum_amount": "0.00",
+      "customer_emails": [],
+      "description": ""
+    },
+    {
+      "id": 527,
+      "code": "free-shipping",
+      "type": "fixed_cart",
+      "created_at": "2015-01-20T18:35:59Z",
+      "updated_at": "2015-07-31T12:10:33Z",
+      "amount": "0.00",
+      "individual_use": true,
+      "product_ids": [],
+      "exclude_product_ids": [],
+      "usage_limit": null,
+      "usage_limit_per_user": null,
+      "limit_usage_to_x_items": 0,
+      "usage_count": 0,
+      "expiry_date": null,
+      "enable_free_shipping": true,
+      "product_category_ids": [],
+      "exclude_product_category_ids": [],
+      "exclude_sale_items": true,
+      "minimum_amount": "55.00",
+      "maximum_amount": "0.00",
+      "customer_emails": [],
+      "description": ""
+    },
+    {
+      "id": 526,
+      "code": "christmas-promo",
+      "type": "percent",
+      "created_at": "2015-01-20T18:10:58Z",
+      "updated_at": "2015-07-31T12:10:33Z",
+      "amount": "20.00",
+      "individual_use": true,
+      "product_ids": [],
+      "exclude_product_ids": [],
+      "usage_limit": null,
+      "usage_limit_per_user": 1,
+      "limit_usage_to_x_items": 0,
+      "usage_count": 0,
+      "expiry_date": "2015-12-25T00:00:00Z",
+      "enable_free_shipping": false,
+      "product_category_ids": [],
+      "exclude_product_category_ids": [],
+      "exclude_sale_items": true,
+      "minimum_amount": "200.00",
+      "maximum_amount": "0.00",
+      "customer_emails": [],
+      "description": "Discount for Christmas for orders over $ 200"
+    }
+  ]
+}
+```
+
 ## Delete A Coupon ##
 
 This API helps you delete a coupon.
diff --git a/source/includes/v3/_customers.md b/source/includes/v3/_customers.md
index e441a065..8938d482 100644
--- a/source/includes/v3/_customers.md
+++ b/source/includes/v3/_customers.md
@@ -652,6 +652,387 @@ woocommerce.put("customers/2", data).parsed_response
 }
 ```
 
+## Create/Update Multiple Customers ##
+
+This API helps you to bulk create/update multiple customers.
+
+To update is necessary to send objects containing IDs and to create new not just send the ID.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-post">POST</i>
+		<h6>/wc-api/v3/customers/bulk</h6>
+	</div>
+</div>
+
+```shell
+curl -X PUT https://example.com/wc-api/v3/customers/bulk \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "customers": [
+    {
+      "email": "john.doe2@example.com",
+      "first_name": "John",
+      "last_name": "Doe",
+      "username": "john.doe2",
+      "billing_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US",
+        "email": "john.doe@example.com",
+        "phone": "(555) 555-5555"
+      },
+      "shipping_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US"
+      }
+    },
+    {
+      "email": "joao.silva2@example.com",
+      "first_name": "João",
+      "last_name": "Silva",
+      "username": "joao.silva2",
+      "billing_address": {
+        "first_name": "João",
+        "last_name": "Silva",
+        "company": "",
+        "address_1": "Av. Brasil, 432",
+        "address_2": "",
+        "city": "Rio de Janeiro",
+        "state": "RJ",
+        "postcode": "12345-000",
+        "country": "BR",
+        "email": "joao.silva@example.com",
+        "phone": "(55) 5555-5555"
+      },
+      "shipping_address": {
+        "first_name": "João",
+        "last_name": "Silva",
+        "company": "",
+        "address_1": "Av. Brasil, 432",
+        "address_2": "",
+        "city": "Rio de Janeiro",
+        "state": "RJ",
+        "postcode": "12345-000",
+        "country": "BR"
+      }
+    }
+  ]
+}'
+```
+
+```javascript
+var data = {
+  customers: [
+    {
+      email: "john.doe2@example.com",
+      first_name: "John",
+      last_name: "Doe",
+      username: "john.doe2",
+      billing_address: {
+        first_name: "John",
+        last_name: "Doe",
+        company: "",
+        address_1: "969 Market",
+        address_2: "",
+        city: "San Francisco",
+        state: "CA",
+        postcode: "94103",
+        country: "US",
+        email: "john.doe@example.com",
+        phone: "(555) 555-5555"
+      },
+      shipping_address: {
+        first_name: "John",
+        last_name: "Doe",
+        company: "",
+        address_1: "969 Market",
+        address_2: "",
+        city: "San Francisco",
+        state: "CA",
+        postcode: "94103",
+        country: "US"
+      }
+    },
+    {
+      email: "joao.silva2@example.com",
+      first_name: "João",
+      last_name: "Silva",
+      username: "joao.silva2",
+      billing_address: {
+        first_name: "João",
+        last_name: "Silva",
+        company: "",
+        address_1: "Av. Brasil, 432",
+        address_2: "",
+        city: "Rio de Janeiro",
+        state: "RJ",
+        postcode: "12345-000",
+        country: "BR",
+        email: "joao.silva@example.com",
+        phone: "(55) 5555-5555"
+      },
+      shipping_address: {
+        first_name: "João",
+        last_name: "Silva",
+        company: "",
+        address_1: "Av. Brasil, 432",
+        address_2: "",
+        city: "Rio de Janeiro",
+        state: "RJ",
+        postcode: "12345-000",
+        country: "BR"
+      }
+    }
+  ]
+};
+
+WooCommerce.put('customers/bulk', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "customers": [
+        {
+            "email": "john.doe2@example.com",
+            "first_name": "John",
+            "last_name": "Doe",
+            "username": "john.doe2",
+            "billing_address": {
+                "first_name": "John",
+                "last_name": "Doe",
+                "company": "",
+                "address_1": "969 Market",
+                "address_2": "",
+                "city": "San Francisco",
+                "state": "CA",
+                "postcode": "94103",
+                "country": "US",
+                "email": "john.doe@example.com",
+                "phone": "(555) 555-5555"
+            },
+            "shipping_address": {
+                "first_name": "John",
+                "last_name": "Doe",
+                "company": "",
+                "address_1": "969 Market",
+                "address_2": "",
+                "city": "San Francisco",
+                "state": "CA",
+                "postcode": "94103",
+                "country": "US"
+            }
+        },
+        {
+            "email": "joao.silva2@example.com",
+            "first_name": "João",
+            "last_name": "Silva",
+            "username": "joao.silva2",
+            "billing_address": {
+                "first_name": "João",
+                "last_name": "Silva",
+                "company": "",
+                "address_1": "Av. Brasil, 432",
+                "address_2": "",
+                "city": "Rio de Janeiro",
+                "state": "RJ",
+                "postcode": "12345-000",
+                "country": "BR",
+                "email": "joao.silva@example.com",
+                "phone": "(55) 5555-5555"
+            },
+            "shipping_address": {
+                "first_name": "João",
+                "last_name": "Silva",
+                "company": "",
+                "address_1": "Av. Brasil, 432",
+                "address_2": "",
+                "city": "Rio de Janeiro",
+                "state": "RJ",
+                "postcode": "12345-000",
+                "country": "BR"
+            }
+        }
+    ]
+}
+
+print(wcapi.put("customers/bulk", data).json())
+```
+
+```php
+
+```
+
+```ruby
+data = {
+  customers: [
+    {
+      email: "john.doe2@example.com",
+      first_name: "John",
+      last_name: "Doe",
+      username: "john.doe2",
+      billing_address: {
+        first_name: "John",
+        last_name: "Doe",
+        company: "",
+        address_1: "969 Market",
+        address_2: "",
+        city: "San Francisco",
+        state: "CA",
+        postcode: "94103",
+        country: "US",
+        email: "john.doe@example.com",
+        phone: "(555) 555-5555"
+      },
+      shipping_address: {
+        first_name: "John",
+        last_name: "Doe",
+        company: "",
+        address_1: "969 Market",
+        address_2: "",
+        city: "San Francisco",
+        state: "CA",
+        postcode: "94103",
+        country: "US"
+      }
+    },
+    {
+      email: "joao.silva2@example.com",
+      first_name: "João",
+      last_name: "Silva",
+      username: "joao.silva2",
+      billing_address: {
+        first_name: "João",
+        last_name: "Silva",
+        company: "",
+        address_1: "Av. Brasil, 432",
+        address_2: "",
+        city: "Rio de Janeiro",
+        state: "RJ",
+        postcode: "12345-000",
+        country: "BR",
+        email: "joao.silva@example.com",
+        phone: "(55) 5555-5555"
+      },
+      shipping_address: {
+        first_name: "João",
+        last_name: "Silva",
+        company: "",
+        address_1: "Av. Brasil, 432",
+        address_2: "",
+        city: "Rio de Janeiro",
+        state: "RJ",
+        postcode: "12345-000",
+        country: "BR"
+      }
+    }
+  ]
+}
+
+woocommerce.put("customers/bulk", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "customers": [
+    {
+      "id": 4,
+      "created_at": "2015-07-31T14:20:46Z",
+      "email": "john.doe2@example.com",
+      "first_name": "John",
+      "last_name": "Doe",
+      "username": "john.doe2",
+      "last_order_id": null,
+      "last_order_date": null,
+      "orders_count": 0,
+      "total_spent": "0.00",
+      "avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
+      "billing_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US",
+        "email": "john.doe@example.com",
+        "phone": "(555) 555-5555"
+      },
+      "shipping_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US"
+      }
+    },
+    {
+      "id": 5,
+      "created_at": "2015-07-31T14:20:46Z",
+      "email": "joao.silva2@example.com",
+      "first_name": "João",
+      "last_name": "Silva",
+      "username": "joao.silva2",
+      "last_order_id": null,
+      "last_order_date": null,
+      "orders_count": 0,
+      "total_spent": "0.00",
+      "avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
+      "billing_address": {
+        "first_name": "João",
+        "last_name": "Silva",
+        "company": "",
+        "address_1": "Av. Brasil, 432",
+        "address_2": "",
+        "city": "Rio de Janeiro",
+        "state": "RJ",
+        "postcode": "12345-000",
+        "country": "BR",
+        "email": "joao.silva@example.com",
+        "phone": "(55) 5555-5555"
+      },
+      "shipping_address": {
+        "first_name": "João",
+        "last_name": "Silva",
+        "company": "",
+        "address_1": "Av. Brasil, 432",
+        "address_2": "",
+        "city": "Rio de Janeiro",
+        "state": "RJ",
+        "postcode": "12345-000",
+        "country": "BR"
+      }
+    }
+  ]
+}
+```
+
 ## Delete A Customer ##
 
 This API helps you delete a customer.
diff --git a/source/includes/v3/_orders.md b/source/includes/v3/_orders.md
index 9db97a4b..8d683c9b 100644
--- a/source/includes/v3/_orders.md
+++ b/source/includes/v3/_orders.md
@@ -1351,6 +1351,405 @@ woocommerce.put("orders/645", data).parsed_response
 }
 ```
 
+## Create/Update Multiple Orders ##
+
+This API helps you to bulk create/update multiple orders.
+
+To update is necessary to send objects containing IDs and to create new not just send the ID.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-post">POST</i>
+		<h6>/wc-api/v3/orders/bulk</h6>
+	</div>
+</div>
+
+```shell
+curl -X PUT https://example.com/wc-api/v3/orders/bulk \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "orders": [
+    {
+      "id": 645,
+      "shipping_methods": "Local Delivery"
+    },
+    {
+      "id": 644,
+      "shipping_methods": "Local Delivery"
+    }
+  ]
+}'
+```
+
+```javascript
+var data = {
+  orders: [
+    {
+      id: 645,
+      shipping_methods: "Local Delivery"
+    },
+    {
+      id: 644,
+      shipping_methods: "Local Delivery"
+    }
+  ]
+};
+
+WooCommerce.put('orders/bulk', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "orders": [
+        {
+            "id": 645,
+            "shipping_methods": "Local Delivery"
+        },
+        {
+            "id": 644,
+            "shipping_methods": "Local Delivery"
+        }
+    ]
+}
+
+print(wcapi.put("orders/bulk", data).json())
+```
+
+```php
+
+```
+
+```ruby
+data = {
+  orders: [
+    {
+      id: 645,
+      shipping_methods: "Local Delivery"
+    },
+    {
+      id: 644,
+      shipping_methods: "Local Delivery"
+    }
+  ]
+}
+
+woocommerce.put("orders/bulk", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "orders": [
+    {
+      "id": 645,
+      "order_number": 645,
+      "created_at": "2015-01-26T20:00:21Z",
+      "updated_at": "2015-07-31T11:45:12Z",
+      "completed_at": "2015-01-26T20:00:21Z",
+      "status": "processing",
+      "currency": "USD",
+      "total": "79.87",
+      "subtotal": "63.97",
+      "total_line_items_quantity": 3,
+      "total_tax": "5.90",
+      "total_shipping": "10.00",
+      "cart_tax": "5.40",
+      "shipping_tax": "0.50",
+      "total_discount": "0.00",
+      "shipping_methods": "Local Delivery",
+      "payment_details": {
+        "method_id": "bacs",
+        "method_title": "Direct Bank Transfer",
+        "paid": true
+      },
+      "billing_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US",
+        "email": "john.doe@example.com",
+        "phone": "(555) 555-5555"
+      },
+      "shipping_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US"
+      },
+      "note": "",
+      "customer_ip": "127.0.0.1",
+      "customer_user_agent": "WordPress/4.1; http://example.com",
+      "customer_id": 2,
+      "view_order_url": "https://example.com/my-account/view-order/645",
+      "line_items": [
+        {
+          "id": 504,
+          "subtotal": "43.98",
+          "subtotal_tax": "4.40",
+          "total": "43.98",
+          "total_tax": "4.40",
+          "price": "21.99",
+          "quantity": 2,
+          "tax_class": "reduced-rate",
+          "name": "Premium Quality",
+          "product_id": 546,
+          "sku": "",
+          "meta": []
+        },
+        {
+          "id": 505,
+          "subtotal": "19.99",
+          "subtotal_tax": "1.00",
+          "total": "19.99",
+          "total_tax": "1.00",
+          "price": "19.99",
+          "quantity": 1,
+          "tax_class": null,
+          "name": "Ship Your Idea",
+          "product_id": 613,
+          "sku": "",
+          "meta": [
+            {
+              "key": "pa_color",
+              "label": "Color",
+              "value": "Black"
+            }
+          ]
+        }
+      ],
+      "shipping_lines": [
+        {
+          "id": 506,
+          "method_id": "flat_rate",
+          "method_title": "Local Delivery",
+          "total": "10.00"
+        }
+      ],
+      "tax_lines": [
+        {
+          "id": 507,
+          "rate_id": "5",
+          "code": "US-CA-TAX-1",
+          "title": "Tax",
+          "total": "4.40",
+          "compound": false
+        },
+        {
+          "id": 508,
+          "rate_id": "4",
+          "code": "US-STANDARD-1",
+          "title": "Standard",
+          "total": "1.50",
+          "compound": false
+        }
+      ],
+      "fee_lines": [],
+      "coupon_lines": [],
+      "customer": {
+        "id": 2,
+        "created_at": "2014-11-19T18:34:19Z",
+        "email": "john.doe@example.com",
+        "first_name": "",
+        "last_name": "",
+        "username": "john.doe",
+        "last_order_id": "645",
+        "last_order_date": "2015-01-26T20:00:21Z",
+        "orders_count": 2,
+        "total_spent": "19.00",
+        "avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
+        "billing_address": {
+          "first_name": "John",
+          "last_name": "Doe",
+          "company": "",
+          "address_1": "969 Market",
+          "address_2": "",
+          "city": "San Francisco",
+          "state": "CA",
+          "postcode": "94103",
+          "country": "US",
+          "email": "john.doe@example.com",
+          "phone": "(555) 555-5555"
+        },
+        "shipping_address": {
+          "first_name": "John",
+          "last_name": "Doe",
+          "company": "",
+          "address_1": "969 Market",
+          "address_2": "",
+          "city": "San Francisco",
+          "state": "CA",
+          "postcode": "94103",
+          "country": "US"
+        }
+      }
+    },
+    {
+      "id": 644,
+      "order_number": 644,
+      "created_at": "2015-01-26T19:33:42Z",
+      "updated_at": "2015-07-31T11:45:12Z",
+      "completed_at": "2015-01-26T19:33:42Z",
+      "status": "on-hold",
+      "currency": "USD",
+      "total": "44.14",
+      "subtotal": "30.99",
+      "total_line_items_quantity": 2,
+      "total_tax": "3.15",
+      "total_shipping": "10.00",
+      "cart_tax": "2.65",
+      "shipping_tax": "0.50",
+      "total_discount": "0.00",
+      "shipping_methods": "Flat Rate",
+      "payment_details": {
+        "method_id": "bacs",
+        "method_title": "Direct Bank Transfer",
+        "paid": false
+      },
+      "billing_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US",
+        "email": "john.doe@example.com",
+        "phone": "(555) 555-5555"
+      },
+      "shipping_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US"
+      },
+      "note": "",
+      "customer_ip": "127.0.0.1",
+      "customer_user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/40.0.2214.91 Safari/537.36",
+      "customer_id": 2,
+      "view_order_url": "https://example.com/my-account/view-order/644",
+      "line_items": [
+        {
+          "id": 499,
+          "subtotal": "21.99",
+          "subtotal_tax": "2.20",
+          "total": "21.99",
+          "total_tax": "2.20",
+          "price": "21.99",
+          "quantity": 1,
+          "tax_class": "reduced-rate",
+          "name": "Premium Quality",
+          "product_id": 546,
+          "sku": "",
+          "meta": []
+        },
+        {
+          "id": 500,
+          "subtotal": "9.00",
+          "subtotal_tax": "0.45",
+          "total": "9.00",
+          "total_tax": "0.45",
+          "price": "9.00",
+          "quantity": 1,
+          "tax_class": null,
+          "name": "Woo Album #4",
+          "product_id": 96,
+          "sku": "",
+          "meta": []
+        }
+      ],
+      "shipping_lines": [
+        {
+          "id": 501,
+          "method_id": "flat_rate",
+          "method_title": "Flat Rate",
+          "total": "10.00"
+        }
+      ],
+      "tax_lines": [
+        {
+          "id": 502,
+          "rate_id": "5",
+          "code": "US-CA-TAX-1",
+          "title": "Tax",
+          "total": "4.40",
+          "compound": false
+        },
+        {
+          "id": 503,
+          "rate_id": "4",
+          "code": "US-STANDARD-1",
+          "title": "Standard",
+          "total": "1.50",
+          "compound": false
+        }
+      ],
+      "fee_lines": [],
+      "coupon_lines": [],
+      "customer": {
+        "id": 2,
+        "created_at": "2014-11-19T18:34:19Z",
+        "email": "john.doe@example.com",
+        "first_name": "",
+        "last_name": "",
+        "username": "john.doe",
+        "last_order_id": "645",
+        "last_order_date": "2015-01-26T20:00:21Z",
+        "orders_count": 2,
+        "total_spent": "19.00",
+        "avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
+        "billing_address": {
+          "first_name": "John",
+          "last_name": "Doe",
+          "company": "",
+          "address_1": "969 Market",
+          "address_2": "",
+          "city": "San Francisco",
+          "state": "CA",
+          "postcode": "94103",
+          "country": "US",
+          "email": "john.doe@example.com",
+          "phone": "(555) 555-5555"
+        },
+        "shipping_address": {
+          "first_name": "John",
+          "last_name": "Doe",
+          "company": "",
+          "address_1": "969 Market",
+          "address_2": "",
+          "city": "San Francisco",
+          "state": "CA",
+          "postcode": "94103",
+          "country": "US"
+        }
+      }
+    }
+  ]
+}
+```
+
 ## Delete An Order ##
 
 This API helps you delete an order.
diff --git a/source/includes/v3/_products.md b/source/includes/v3/_products.md
index 17e05c79..4054e6f0 100644
--- a/source/includes/v3/_products.md
+++ b/source/includes/v3/_products.md
@@ -1775,6 +1775,458 @@ woocommerce.put("products/546", data).parsed_response
 }
 ```
 
+## Create/Update Multiple Products ##
+
+This API helps you to bulk create/update multiple products.
+
+To update is necessary to send objects containing IDs and to create new not just send the ID.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-post">POST</i>
+		<h6>/wc-api/v3/products/bulk</h6>
+	</div>
+</div>
+
+```shell
+curl -X PUT https://example.com/wc-api/v3/products/bulk \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "products": [
+    {
+      "id": 546,
+      "regular_price": "29.99"
+    },
+    {
+      "id": 604,
+      "variations": [
+        {
+          "id": 609,
+          "regular_price": "29.99"
+        },
+        {
+          "id": 611,
+          "regular_price": "29.99"
+        }
+      ]
+    }
+  ]
+}'
+```
+
+```javascript
+var data = {
+  products: [
+    {
+      id: 546,
+      regular_price: "29.99"
+    },
+    {
+      id: 604,
+      variations: [
+        {
+          id: 609,
+          regular_price: "29.99"
+        },
+        {
+          id: 611,
+          regular_price: "29.99"
+        }
+      ]
+    }
+  ]
+};
+
+WooCommerce.put('products/bulk', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "products": [
+        {
+            "id": 546,
+            "regular_price": "29.99"
+        },
+        {
+            "id": 604,
+            "variations": [
+                {
+                    "id": 609,
+                    "regular_price": "29.99"
+                },
+                {
+                    "id": 611,
+                    "regular_price": "29.99"
+                }
+            ]
+        }
+    ]
+}
+
+print(wcapi.put("products/bulk", data).json())
+```
+
+```php
+
+```
+
+```ruby
+data = {
+  products: [
+    {
+      id: 546,
+      regular_price: "29.99"
+    },
+    {
+      id: 604,
+      variations: [
+        {
+          id: 609,
+          regular_price: "29.99"
+        },
+        {
+          id: 611,
+          regular_price: "29.99"
+        }
+      ]
+    }
+  ]
+}
+
+woocommerce.put("products/bulk", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "products": [
+    {
+      "title": "Premium Quality",
+      "id": 546,
+      "created_at": "2015-01-22T19:46:16Z",
+      "updated_at": "2015-07-27T14:22:32Z",
+      "type": "simple",
+      "status": "publish",
+      "downloadable": false,
+      "virtual": false,
+      "permalink": "https://example.com/product/premium-quality/",
+      "sku": "",
+      "price": "29.99",
+      "regular_price": "29.99",
+      "sale_price": null,
+      "price_html": "<span class=\"amount\">&#36;&nbsp;29.99</span>",
+      "taxable": true,
+      "tax_status": "taxable",
+      "tax_class": "",
+      "managing_stock": false,
+      "stock_quantity": 0,
+      "in_stock": true,
+      "backorders_allowed": false,
+      "backordered": false,
+      "sold_individually": false,
+      "purchaseable": true,
+      "featured": false,
+      "visible": true,
+      "catalog_visibility": "visible",
+      "on_sale": false,
+      "weight": null,
+      "dimensions": {
+        "length": "",
+        "width": "",
+        "height": "",
+        "unit": "cm"
+      },
+      "shipping_required": true,
+      "shipping_taxable": true,
+      "shipping_class": "",
+      "shipping_class_id": null,
+      "description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.</p>\n",
+      "short_description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.</p>\n",
+      "reviews_allowed": true,
+      "average_rating": "0.00",
+      "rating_count": 0,
+      "related_ids": [
+        37,
+        47,
+        31,
+        19,
+        22
+      ],
+      "upsell_ids": [],
+      "cross_sell_ids": [],
+      "parent_id": 0,
+      "categories": [
+        "Clothing",
+        "T-shirts"
+      ],
+      "tags": [],
+      "images": [
+        {
+          "id": 547,
+          "created_at": "2015-01-22T19:46:16Z",
+          "updated_at": "2015-01-22T19:46:16Z",
+          "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
+          "title": "",
+          "alt": "",
+          "position": 0
+        },
+        {
+          "id": 548,
+          "created_at": "2015-01-22T19:46:17Z",
+          "updated_at": "2015-01-22T19:46:17Z",
+          "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-back.jpg",
+          "title": "",
+          "alt": "",
+          "position": 1
+        }
+      ],
+      "featured_src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
+      "attributes": [],
+      "downloads": [],
+      "download_limit": 0,
+      "download_expiry": 0,
+      "download_type": "",
+      "purchase_note": "",
+      "total_sales": 0,
+      "variations": [],
+      "parent": []
+    },
+    {
+      "title": "Ship Your Idea",
+      "id": 604,
+      "created_at": "2015-01-22T20:37:14Z",
+      "updated_at": "2015-07-27T14:22:32Z",
+      "type": "variable",
+      "status": "publish",
+      "downloadable": false,
+      "virtual": false,
+      "permalink": "https://example/product/ship-your-idea/",
+      "sku": "",
+      "price": "29.99",
+      "regular_price": "0.00",
+      "sale_price": null,
+      "price_html": "<span class=\"amount\">&#36;&nbsp;29.99</span>",
+      "taxable": true,
+      "tax_status": "taxable",
+      "tax_class": "",
+      "managing_stock": false,
+      "stock_quantity": 0,
+      "in_stock": true,
+      "backorders_allowed": false,
+      "backordered": false,
+      "sold_individually": false,
+      "purchaseable": true,
+      "featured": false,
+      "visible": true,
+      "catalog_visibility": "visible",
+      "on_sale": false,
+      "weight": null,
+      "dimensions": {
+        "length": "",
+        "width": "",
+        "height": "",
+        "unit": "cm"
+      },
+      "shipping_required": true,
+      "shipping_taxable": true,
+      "shipping_class": "",
+      "shipping_class_id": null,
+      "description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.</p>\n",
+      "short_description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.</p>\n",
+      "reviews_allowed": true,
+      "average_rating": "0.00",
+      "rating_count": 0,
+      "related_ids": [
+        40,
+        37,
+        47,
+        577,
+        34
+      ],
+      "upsell_ids": [],
+      "cross_sell_ids": [],
+      "parent_id": 0,
+      "categories": [
+        "Clothing",
+        "T-shirts"
+      ],
+      "tags": [],
+      "images": [
+        {
+          "id": 605,
+          "created_at": "2015-01-22T20:37:14Z",
+          "updated_at": "2015-01-22T20:37:14Z",
+          "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
+          "title": "",
+          "alt": "",
+          "position": 0
+        },
+        {
+          "id": 606,
+          "created_at": "2015-01-22T20:37:15Z",
+          "updated_at": "2015-01-22T20:37:15Z",
+          "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-back.jpg",
+          "title": "",
+          "alt": "",
+          "position": 1
+        },
+        {
+          "id": 607,
+          "created_at": "2015-01-22T20:37:15Z",
+          "updated_at": "2015-01-22T20:37:15Z",
+          "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
+          "title": "",
+          "alt": "",
+          "position": 2
+        },
+        {
+          "id": 608,
+          "created_at": "2015-01-22T20:37:16Z",
+          "updated_at": "2015-01-22T20:37:16Z",
+          "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-green-back.jpg",
+          "title": "",
+          "alt": "",
+          "position": 3
+        }
+      ],
+      "featured_src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
+      "attributes": [
+        {
+          "name": "Color",
+          "slug": "color",
+          "position": 0,
+          "visible": false,
+          "variation": true,
+          "options": [
+            "Black",
+            "Green"
+          ]
+        }
+      ],
+      "downloads": [],
+      "download_limit": 0,
+      "download_expiry": 0,
+      "download_type": "",
+      "purchase_note": "",
+      "total_sales": 0,
+      "variations": [
+        {
+          "id": 609,
+          "created_at": "2015-01-22T20:37:14Z",
+          "updated_at": "2015-07-27T14:22:32Z",
+          "downloadable": false,
+          "virtual": false,
+          "permalink": "https://example/product/ship-your-idea-10/?attribute_pa_color=black",
+          "sku": "",
+          "price": "29.99",
+          "regular_price": "29.99",
+          "sale_price": null,
+          "taxable": true,
+          "tax_status": "taxable",
+          "tax_class": "",
+          "managing_stock": false,
+          "stock_quantity": 0,
+          "in_stock": true,
+          "backordered": false,
+          "purchaseable": true,
+          "visible": true,
+          "on_sale": false,
+          "weight": null,
+          "dimensions": {
+            "length": "",
+            "width": "",
+            "height": "",
+            "unit": "cm"
+          },
+          "shipping_class": "",
+          "shipping_class_id": null,
+          "image": [
+            {
+              "id": 610,
+              "created_at": "2015-01-22T20:37:18Z",
+              "updated_at": "2015-07-27T14:22:32Z",
+              "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
+              "title": "",
+              "alt": "",
+              "position": 0
+            }
+          ],
+          "attributes": [
+            {
+              "name": "Color",
+              "slug": "color",
+              "option": "black"
+            }
+          ],
+          "downloads": [],
+          "download_limit": 0,
+          "download_expiry": 0
+        },
+        {
+          "id": 611,
+          "created_at": "2015-01-22T20:37:14Z",
+          "updated_at": "2015-07-27T14:22:32Z",
+          "downloadable": false,
+          "virtual": false,
+          "permalink": "https://example/product/ship-your-idea-10/?attribute_pa_color=green",
+          "sku": "",
+          "price": "29.99",
+          "regular_price": "29.99",
+          "sale_price": null,
+          "taxable": true,
+          "tax_status": "taxable",
+          "tax_class": "",
+          "managing_stock": false,
+          "stock_quantity": 0,
+          "in_stock": true,
+          "backordered": false,
+          "purchaseable": true,
+          "visible": true,
+          "on_sale": false,
+          "weight": null,
+          "dimensions": {
+            "length": "",
+            "width": "",
+            "height": "",
+            "unit": "cm"
+          },
+          "shipping_class": "",
+          "shipping_class_id": null,
+          "image": [
+            {
+              "id": 612,
+              "created_at": "2015-01-22T20:37:19Z",
+              "updated_at": "2015-01-22T20:37:19Z",
+              "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
+              "title": "",
+              "alt": "",
+              "position": 0
+            }
+          ],
+          "attributes": [
+            {
+              "name": "Color",
+              "slug": "color",
+              "option": "green"
+            }
+          ],
+          "downloads": [],
+          "download_limit": 0,
+          "download_expiry": 0
+        }
+      ],
+      "parent": []
+    }
+  ]
+}
+```
+
 ## Delete A Product ##
 
 This API helps you delete a product.

From f978679dcd9bf49ccd86e91712bd3a6a2d64adcb Mon Sep 17 00:00:00 2001
From: Claudio Sanches <contato@claudiosmweb.com>
Date: Fri, 31 Jul 2015 22:34:55 -0300
Subject: [PATCH 08/18] Updated index example

---
 source/includes/v3/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/includes/v3/_index.md b/source/includes/v3/_index.md
index 21dd06bb..7e6fc624 100644
--- a/source/includes/v3/_index.md
+++ b/source/includes/v3/_index.md
@@ -91,7 +91,7 @@ woocommerce.get("").parsed_response
         "meta": {
             "currency": "USD",
             "currency_format": "&#36;",
-            "currency_position": "left",
+            "currency_position": "left_space",
             "decimal_separator": ",",
             "dimension_unit": "in",
             "generate_password": false,

From c2f51dc3838b1fdd4d6365d642dc5e18ce2f298b Mon Sep 17 00:00:00 2001
From: Claudio Sanches <contato@claudiosmweb.com>
Date: Fri, 31 Jul 2015 22:39:43 -0300
Subject: [PATCH 09/18] Updated docs about the new behavior for passwords in
 the customers endpoint

---
 source/includes/v2/_customers.md | 32 ++++++++++++++++----------------
 source/includes/v3/_customers.md | 32 ++++++++++++++++----------------
 2 files changed, 32 insertions(+), 32 deletions(-)

diff --git a/source/includes/v2/_customers.md b/source/includes/v2/_customers.md
index 797a110d..ea47d438 100644
--- a/source/includes/v2/_customers.md
+++ b/source/includes/v2/_customers.md
@@ -4,22 +4,22 @@ This section lists all API that can be used to create, edit or otherwise manipul
 
 ## Customers Properties ##
 
-|     Attribute      |   Type  |                                                                                                    Description                                                                                                     |
-| ------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `id`               | integer | Customer ID (user ID) <i class="label label-info">read-only</i>                                                                                                                                                    |
-| `created_at`       | string  | UTC DateTime when the customer was created <i class="label label-info">read-only</i>                                                                                                                               |
-| `email`            | string  | Customer email address <i class="label label-info">mandatory</i>                                                                                                                                                   |
-| `first_name`       | string  | Customer first name                                                                                                                                                                                                |
-| `last_name`        | string  | Customer last name                                                                                                                                                                                                 |
-| `username`         | string  | Customer username, can be generated automatically from the customer's email addrees if the option `woocommerce_registration_generate_username` is equal to `yes` <i class="label label-info">cannot be changed</i> |
-| `password`         | string  | Customer password, can be generated automatically with [`wp_generate_password()`](http://codex.wordpress.org/Function_Reference/wp_generate_password) <i class="label label-info">write-only</i>                   |
-| `last_order_id`    | integer | Last order ID <i class="label label-info">read-only</i>                                                                                                                                                            |
-| `last_order_date`  | string  | UTC DateTime of the customer last order <i class="label label-info">read-only</i>                                                                                                                                  |
-| `orders_count`     | integer | Quantity of orders that the customer have <i class="label label-info">read-only</i>                                                                                                                                |
-| `total_spent`      | integer | Total amount spent <i class="label label-info">read-only</i>                                                                                                                                                       |
-| `avatar_url`       | string  | Gravatar URL                                                                                                                                                                                                       |
-| `billing_address`  | array   | List of Billing Address fields. See [Billing Address Properties](#billing-address-properties)                                                                                                                      |
-| `shipping_address` | array   | List of Shipping Address fields. See [Shipping Address Properties](#shipping-address-properties)                                                                                                                   |
+|     Attribute      |   Type  |                                                                                                                                                    Description                                                                                                                                                     |
+| ------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `id`               | integer | Customer ID (user ID) <i class="label label-info">read-only</i>                                                                                                                                                                                                                                                    |
+| `created_at`       | string  | UTC DateTime when the customer was created <i class="label label-info">read-only</i>                                                                                                                                                                                                                               |
+| `email`            | string  | Customer email address <i class="label label-info">mandatory</i>                                                                                                                                                                                                                                                   |
+| `first_name`       | string  | Customer first name                                                                                                                                                                                                                                                                                                |
+| `last_name`        | string  | Customer last name                                                                                                                                                                                                                                                                                                 |
+| `username`         | string  | Customer username, can be generated automatically from the customer's email addrees if the option `woocommerce_registration_generate_username` is equal to `yes` <i class="label label-info">cannot be changed</i>                                                                                                 |
+| `password`         | string  | Customer password, can be generated automatically with [`wp_generate_password()`](http://codex.wordpress.org/Function_Reference/wp_generate_password) if the "Automatically generate customer password" option is enabled, check the index meta for `generate_password` <i class="label label-info">write-only</i> |
+| `last_order_id`    | integer | Last order ID <i class="label label-info">read-only</i>                                                                                                                                                                                                                                                            |
+| `last_order_date`  | string  | UTC DateTime of the customer last order <i class="label label-info">read-only</i>                                                                                                                                                                                                                                  |
+| `orders_count`     | integer | Quantity of orders that the customer have <i class="label label-info">read-only</i>                                                                                                                                                                                                                                |
+| `total_spent`      | integer | Total amount spent <i class="label label-info">read-only</i>                                                                                                                                                                                                                                                       |
+| `avatar_url`       | string  | Gravatar URL                                                                                                                                                                                                                                                                                                       |
+| `billing_address`  | array   | List of Billing Address fields. See [Billing Address Properties](#billing-address-properties)                                                                                                                                                                                                                      |
+| `shipping_address` | array   | List of Shipping Address fields. See [Shipping Address Properties](#shipping-address-properties)                                                                                                                                                                                                                   |
 
 ### Billing Address Properties ###
 
diff --git a/source/includes/v3/_customers.md b/source/includes/v3/_customers.md
index 8938d482..6009fce6 100644
--- a/source/includes/v3/_customers.md
+++ b/source/includes/v3/_customers.md
@@ -4,22 +4,22 @@ This section lists all API that can be used to create, edit or otherwise manipul
 
 ## Customers Properties ##
 
-|     Attribute      |   Type  |                                                                                                    Description                                                                                                     |
-| ------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `id`               | integer | Customer ID (user ID) <i class="label label-info">read-only</i>                                                                                                                                                    |
-| `created_at`       | string  | UTC DateTime when the customer was created <i class="label label-info">read-only</i>                                                                                                                               |
-| `email`            | string  | Customer email address <i class="label label-info">mandatory</i>                                                                                                                                                   |
-| `first_name`       | string  | Customer first name                                                                                                                                                                                                |
-| `last_name`        | string  | Customer last name                                                                                                                                                                                                 |
-| `username`         | string  | Customer username, can be generated automatically from the customer's email addrees if the option `woocommerce_registration_generate_username` is equal to `yes` <i class="label label-info">cannot be changed</i> |
-| `password`         | string  | Customer password, can be generated automatically with [`wp_generate_password()`](http://codex.wordpress.org/Function_Reference/wp_generate_password) <i class="label label-info">write-only</i>                   |
-| `last_order_id`    | integer | Last order ID <i class="label label-info">read-only</i>                                                                                                                                                            |
-| `last_order_date`  | string  | UTC DateTime of the customer last order <i class="label label-info">read-only</i>                                                                                                                                  |
-| `orders_count`     | integer | Quantity of orders that the customer have <i class="label label-info">read-only</i>                                                                                                                                |
-| `total_spent`      | integer | Total amount spent <i class="label label-info">read-only</i>                                                                                                                                                       |
-| `avatar_url`       | string  | Gravatar URL                                                                                                                                                                                                       |
-| `billing_address`  | array   | List of Billing Address fields. See [Billing Address Properties](#billing-address-properties)                                                                                                                      |
-| `shipping_address` | array   | List of Shipping Address fields. See [Shipping Address Properties](#shipping-address-properties)                                                                                                                   |
+|     Attribute      |   Type  |                                                                                                                                                    Description                                                                                                                                                     |
+| ------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `id`               | integer | Customer ID (user ID) <i class="label label-info">read-only</i>                                                                                                                                                                                                                                                    |
+| `created_at`       | string  | UTC DateTime when the customer was created <i class="label label-info">read-only</i>                                                                                                                                                                                                                               |
+| `email`            | string  | Customer email address <i class="label label-info">mandatory</i>                                                                                                                                                                                                                                                   |
+| `first_name`       | string  | Customer first name                                                                                                                                                                                                                                                                                                |
+| `last_name`        | string  | Customer last name                                                                                                                                                                                                                                                                                                 |
+| `username`         | string  | Customer username, can be generated automatically from the customer's email addrees if the option `woocommerce_registration_generate_username` is equal to `yes` <i class="label label-info">cannot be changed</i>                                                                                                 |
+| `password`         | string  | Customer password, can be generated automatically with [`wp_generate_password()`](http://codex.wordpress.org/Function_Reference/wp_generate_password) if the "Automatically generate customer password" option is enabled, check the index meta for `generate_password` <i class="label label-info">write-only</i> |
+| `last_order_id`    | integer | Last order ID <i class="label label-info">read-only</i>                                                                                                                                                                                                                                                            |
+| `last_order_date`  | string  | UTC DateTime of the customer last order <i class="label label-info">read-only</i>                                                                                                                                                                                                                                  |
+| `orders_count`     | integer | Quantity of orders that the customer have <i class="label label-info">read-only</i>                                                                                                                                                                                                                                |
+| `total_spent`      | integer | Total amount spent <i class="label label-info">read-only</i>                                                                                                                                                                                                                                                       |
+| `avatar_url`       | string  | Gravatar URL                                                                                                                                                                                                                                                                                                       |
+| `billing_address`  | array   | List of Billing Address fields. See [Billing Address Properties](#billing-address-properties)                                                                                                                                                                                                                      |
+| `shipping_address` | array   | List of Shipping Address fields. See [Shipping Address Properties](#shipping-address-properties)                                                                                                                                                                                                                   |
 
 ### Billing Address Properties ###
 

From 9980f74a5d94c5e20a03c13929ef5f8571a5e644 Mon Sep 17 00:00:00 2001
From: Claudio Sanches <contato@claudiosmweb.com>
Date: Fri, 31 Jul 2015 22:47:04 -0300
Subject: [PATCH 10/18] Added docs for new products/categories attributes

---
 source/includes/v2/_products.md | 38 ++++++++++++++++++++++++---------
 source/includes/v3/_products.md | 34 ++++++++++++++++++++++-------
 2 files changed, 54 insertions(+), 18 deletions(-)

diff --git a/source/includes/v2/_products.md b/source/includes/v2/_products.md
index 8677c882..4539076e 100644
--- a/source/includes/v2/_products.md
+++ b/source/includes/v2/_products.md
@@ -1988,6 +1988,8 @@ woocommerce.get("products/categories/9").parsed_response
     "slug": "clothing",
     "parent": 0,
     "description": "",
+    "display": "default",
+    "image": "",
     "count": 23
   }
 }
@@ -1995,26 +1997,28 @@ woocommerce.get("products/categories/9").parsed_response
 
 ### Product Category Properties ###
 
-|   Attribute   |   Type  |                                        Description                                        |
-| ------------- | ------- | ----------------------------------------------------------------------------------------- |
-| `id`          | integer | Category ID (term ID) <i class="label label-info">read-only</i>                           |
-| `name`        | string  | Category Name <i class="label label-info">read-only</i>                                   |
-| `slug`        | string  | Category slug <i class="label label-info">read-only</i>                                   |
-| `parent`      | integer | Category parent <i class="label label-info">read-only</i>                                 |
-| `description` | string  | Category description <i class="label label-info">read-only</i>                            |
-| `count`       | boolean | Shows the quantity of products in this category <i class="label label-info">read-only</i> |
+|   Attribute   |   Type  |                                                                       Description                                                                       |
+| ------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `id`          | integer | Category ID (term ID) <i class="label label-info">read-only</i>                                                                                         |
+| `name`        | string  | Category Name <i class="label label-info">read-only</i>                                                                                                 |
+| `slug`        | string  | Category slug <i class="label label-info">read-only</i>                                                                                                 |
+| `parent`      | integer | Category parent <i class="label label-info">read-only</i>                                                                                               |
+| `description` | string  | Category description <i class="label label-info">read-only</i>                                                                                          |
+| `display`     | string  | Category archive display type, the types available include: `default`, `products`, `subcategories` and `both` <i class="label label-info">read-only</i> |
+| `image`       | string  | Category image URL <i class="label label-info">read-only</i>                                                                                            |
+| `count`       | boolean | Shows the quantity of products in this category <i class="label label-info">read-only</i>                                                               |
 
 ## View List Of Product Categories ##
 
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v2/products/categories</h6>
+		<h6>/wc-api/v3/products/categories</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v2/products/categories \
+curl https://example.com/wc-api/v3/products/categories \
 	-u consumer_key:consumer_secret
 ```
 
@@ -2047,6 +2051,8 @@ woocommerce.get("products/categories").parsed_response
       "slug": "albums",
       "parent": 11,
       "description": "",
+      "display": "default",
+      "image": "",
       "count": 4
     },
     {
@@ -2055,6 +2061,8 @@ woocommerce.get("products/categories").parsed_response
       "slug": "clothing",
       "parent": 0,
       "description": "",
+      "display": "default",
+      "image": "",
       "count": 23
     },
     {
@@ -2063,6 +2071,8 @@ woocommerce.get("products/categories").parsed_response
       "slug": "hoodies",
       "parent": 9,
       "description": "",
+      "display": "default",
+      "image": "",
       "count": 6
     },
     {
@@ -2071,6 +2081,8 @@ woocommerce.get("products/categories").parsed_response
       "slug": "music",
       "parent": 0,
       "description": "",
+      "display": "default",
+      "image": "",
       "count": 6
     },
     {
@@ -2079,6 +2091,8 @@ woocommerce.get("products/categories").parsed_response
       "slug": "posters",
       "parent": 0,
       "description": "",
+      "display": "default",
+      "image": "",
       "count": 5
     },
     {
@@ -2087,6 +2101,8 @@ woocommerce.get("products/categories").parsed_response
       "slug": "singles",
       "parent": 11,
       "description": "",
+      "display": "default",
+      "image": "",
       "count": 2
     },
     {
@@ -2095,6 +2111,8 @@ woocommerce.get("products/categories").parsed_response
       "slug": "t-shirts",
       "parent": 9,
       "description": "",
+      "display": "default",
+      "image": "",
       "count": 17
     }
   ]
diff --git a/source/includes/v3/_products.md b/source/includes/v3/_products.md
index 4054e6f0..d5120a6d 100644
--- a/source/includes/v3/_products.md
+++ b/source/includes/v3/_products.md
@@ -2440,6 +2440,8 @@ woocommerce.get("products/categories/9").parsed_response
     "slug": "clothing",
     "parent": 0,
     "description": "",
+    "display": "default",
+    "image": "",
     "count": 23
   }
 }
@@ -2447,14 +2449,16 @@ woocommerce.get("products/categories/9").parsed_response
 
 ### Product Category Properties ###
 
-|   Attribute   |   Type  |                                        Description                                        |
-| ------------- | ------- | ----------------------------------------------------------------------------------------- |
-| `id`          | integer | Category ID (term ID) <i class="label label-info">read-only</i>                           |
-| `name`        | string  | Category Name <i class="label label-info">read-only</i>                                   |
-| `slug`        | string  | Category slug <i class="label label-info">read-only</i>                                   |
-| `parent`      | integer | Category parent <i class="label label-info">read-only</i>                                 |
-| `description` | string  | Category description <i class="label label-info">read-only</i>                            |
-| `count`       | boolean | Shows the quantity of products in this category <i class="label label-info">read-only</i> |
+|   Attribute   |   Type  |                                                                       Description                                                                       |
+| ------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `id`          | integer | Category ID (term ID) <i class="label label-info">read-only</i>                                                                                         |
+| `name`        | string  | Category Name <i class="label label-info">read-only</i>                                                                                                 |
+| `slug`        | string  | Category slug <i class="label label-info">read-only</i>                                                                                                 |
+| `parent`      | integer | Category parent <i class="label label-info">read-only</i>                                                                                               |
+| `description` | string  | Category description <i class="label label-info">read-only</i>                                                                                          |
+| `display`     | string  | Category archive display type, the types available include: `default`, `products`, `subcategories` and `both` <i class="label label-info">read-only</i> |
+| `image`       | string  | Category image URL <i class="label label-info">read-only</i>                                                                                            |
+| `count`       | boolean | Shows the quantity of products in this category <i class="label label-info">read-only</i>                                                               |
 
 ## View List Of Product Categories ##
 
@@ -2499,6 +2503,8 @@ woocommerce.get("products/categories").parsed_response
       "slug": "albums",
       "parent": 11,
       "description": "",
+      "display": "default",
+      "image": "",
       "count": 4
     },
     {
@@ -2507,6 +2513,8 @@ woocommerce.get("products/categories").parsed_response
       "slug": "clothing",
       "parent": 0,
       "description": "",
+      "display": "default",
+      "image": "",
       "count": 23
     },
     {
@@ -2515,6 +2523,8 @@ woocommerce.get("products/categories").parsed_response
       "slug": "hoodies",
       "parent": 9,
       "description": "",
+      "display": "default",
+      "image": "",
       "count": 6
     },
     {
@@ -2523,6 +2533,8 @@ woocommerce.get("products/categories").parsed_response
       "slug": "music",
       "parent": 0,
       "description": "",
+      "display": "default",
+      "image": "",
       "count": 6
     },
     {
@@ -2531,6 +2543,8 @@ woocommerce.get("products/categories").parsed_response
       "slug": "posters",
       "parent": 0,
       "description": "",
+      "display": "default",
+      "image": "",
       "count": 5
     },
     {
@@ -2539,6 +2553,8 @@ woocommerce.get("products/categories").parsed_response
       "slug": "singles",
       "parent": 11,
       "description": "",
+      "display": "default",
+      "image": "",
       "count": 2
     },
     {
@@ -2547,6 +2563,8 @@ woocommerce.get("products/categories").parsed_response
       "slug": "t-shirts",
       "parent": 9,
       "description": "",
+      "display": "default",
+      "image": "",
       "count": 17
     }
   ]

From 0becca40a17f7e1da7ca58306be843ac7f0f49b4 Mon Sep 17 00:00:00 2001
From: Claudio Sanches <contato@claudiosmweb.com>
Date: Fri, 31 Jul 2015 22:49:31 -0300
Subject: [PATCH 11/18] Remove v3 reference about products/sku deprecated
 endpoint

---
 source/includes/v3/_products.md | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/source/includes/v3/_products.md b/source/includes/v3/_products.md
index d5120a6d..ab0b5b35 100644
--- a/source/includes/v3/_products.md
+++ b/source/includes/v3/_products.md
@@ -1111,13 +1111,6 @@ This API lets you retrieve and view a specific product by ID or sku.
 	</div>
 </div>
 
-<div class="api-endpoint">
-	<div class="endpoint-data">
-		<i class="label label-get">GET</i>
-		<h6>/wc-api/v3/products/sku/&lt;sku&gt;</h6>
-	</div>
-</div>
-
 ```shell
 curl https://example.com/wc-api/v3/products/546 \
 	-u consumer_key:consumer_secret

From 18d616604747893ad02db488e0da26c66ed16e72 Mon Sep 17 00:00:00 2001
From: Claudio Sanches <contato@claudiosmweb.com>
Date: Mon, 10 Aug 2015 13:49:51 -0300
Subject: [PATCH 12/18] Fixed the specs links for basic auth

---
 source/includes/v3/_introduction.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/includes/v3/_introduction.md b/source/includes/v3/_introduction.md
index 1187f2c6..aa930949 100644
--- a/source/includes/v3/_introduction.md
+++ b/source/includes/v3/_introduction.md
@@ -37,7 +37,7 @@ The `v1` and `v2` will be removed in future versions.
 
 ### Differences between v3 and old versions ###
 
-* v3 implement full basic authentication ([conforms to the Basic auth spec)](http://www.w3.org/Protocols/HTTP/1.0/spec.html)).
+* v3 implement full basic authentication ([conforms to the Basic auth spec)](http://tools.ietf.org/html/rfc2617)).
 * v3 fixes the OAuth implementation to be compliant with the [Oauth 1.0a specs](http://tools.ietf.org/html/rfc5849).
 * v3 include a new endpoint to get all product orders.
 * v3 have new endpoints to allow bulk actions as edition and creation of products, orders, customers and coupons.

From 0a70c8dde614d35053af3b3f07fd1f459f8c5481 Mon Sep 17 00:00:00 2001
From: Claudio Sanches <contato@claudiosmweb.com>
Date: Mon, 10 Aug 2015 13:50:17 -0300
Subject: [PATCH 13/18] Fixed the basic auth specs links for v2

---
 source/includes/v2/_introduction.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/includes/v2/_introduction.md b/source/includes/v2/_introduction.md
index 30973c17..d34c8132 100644
--- a/source/includes/v2/_introduction.md
+++ b/source/includes/v2/_introduction.md
@@ -37,7 +37,7 @@ The `v1` and `v2` will be removed in future versions.
 
 ### Differences between v3 and old versions ###
 
-* v3 implement full basic authentication ([conforms to the Basic auth spec)](http://www.w3.org/Protocols/HTTP/1.0/spec.html)).
+* v3 implement full basic authentication ([conforms to the Basic auth spec)](http://tools.ietf.org/html/rfc2617)).
 * v3 fixes the OAuth implementation to be compliant with the [Oauth 1.0a specs](http://tools.ietf.org/html/rfc5849).
 * v3 include a new endpoint to get all product orders.
 * v3 have new endpoints to allow bulk actions as edition and creation of products, orders, customers and coupons.

From db62b68c1087e48e081102fafae9f168dc6dc9a0 Mon Sep 17 00:00:00 2001
From: Claudio Sanches <contato@claudiosmweb.com>
Date: Mon, 10 Aug 2015 13:50:24 -0300
Subject: [PATCH 14/18] Fixed coupons example

---
 source/includes/v2/_coupons.md | 4 ++--
 source/includes/v3/_coupons.md | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/source/includes/v2/_coupons.md b/source/includes/v2/_coupons.md
index c86e88f7..d23cbab0 100644
--- a/source/includes/v2/_coupons.md
+++ b/source/includes/v2/_coupons.md
@@ -102,7 +102,7 @@ WooCommerce.post('coupons', data, function(err, data, res) {
 ```python
 data = {
     "coupon": {
-        "code": "new-coupon3",
+        "code": "new-coupon",
         "type": "percent",
         "amount": "10",
         "individual_use": True,
@@ -130,7 +130,7 @@ print(wcapi.post("coupons", data).json())
 <?php
 $data = array(
     'coupon' => array(
-        'code' => 'new-coupon3',
+        'code' => 'new-coupon',
         'type' => 'percent',
         'amount' => '10',
         'individual_use' => true,
diff --git a/source/includes/v3/_coupons.md b/source/includes/v3/_coupons.md
index cf305adb..d22866e4 100644
--- a/source/includes/v3/_coupons.md
+++ b/source/includes/v3/_coupons.md
@@ -102,7 +102,7 @@ WooCommerce.post('coupons', data, function(err, data, res) {
 ```python
 data = {
     "coupon": {
-        "code": "new-coupon3",
+        "code": "new-coupon",
         "type": "percent",
         "amount": "10",
         "individual_use": True,
@@ -130,7 +130,7 @@ print(wcapi.post("coupons", data).json())
 <?php
 $data = array(
     'coupon' => array(
-        'code' => 'new-coupon3',
+        'code' => 'new-coupon',
         'type' => 'percent',
         'amount' => '10',
         'individual_use' => true,

From aaeffb1435abff89ee805c0f297489466a3491af Mon Sep 17 00:00:00 2001
From: Claudio Sanches <contato@claudiosmweb.com>
Date: Mon, 10 Aug 2015 13:55:00 -0300
Subject: [PATCH 15/18] Removed PHP examples for now

---
 source/includes/v3/_coupons.md      |  61 ----------
 source/includes/v3/_customers.md    |  85 --------------
 source/includes/v3/_index.md        |   4 -
 source/includes/v3/_introduction.md |  17 ---
 source/includes/v3/_orders.md       | 166 ----------------------------
 source/includes/v3/_products.md     | 165 ---------------------------
 source/includes/v3/_reports.md      |  29 -----
 source/includes/v3/_webhooks.md     |  51 ---------
 source/index.md                     |   1 -
 9 files changed, 579 deletions(-)

diff --git a/source/includes/v3/_coupons.md b/source/includes/v3/_coupons.md
index d22866e4..90ed849f 100644
--- a/source/includes/v3/_coupons.md
+++ b/source/includes/v3/_coupons.md
@@ -126,35 +126,6 @@ data = {
 print(wcapi.post("coupons", data).json())
 ```
 
-```php
-<?php
-$data = array(
-    'coupon' => array(
-        'code' => 'new-coupon',
-        'type' => 'percent',
-        'amount' => '10',
-        'individual_use' => true,
-        'product_ids' => array(),
-        'exclude_product_ids' => array(),
-        'usage_limit' => '',
-        'usage_limit_per_user' => '',
-        'limit_usage_to_x_items' => '',
-        'expiry_date' => '',
-        'enable_free_shipping' => false,
-        'product_category_ids' => array(),
-        'exclude_product_category_ids' => array(),
-        'exclude_sale_items' => true,
-        'minimum_amount' => '100.00',
-        'maximum_amount' => '0.00',
-        'customer_emails' => array(),
-        'description' => ''
-    )
-);
-
-print_r($woocommerce->coupons->create($data));
-?>
-```
-
 ```ruby
 data = {
   coupon: {
@@ -248,10 +219,6 @@ WooCommerce.get('coupons/529', function(err, data, res) {
 print(wcapi.get("coupons/529").json())
 ```
 
-```php
-<?php print_r($woocommerce->coupons->get(529)); ?>
-```
-
 ```ruby
 woocommerce.get("coupons/529").parsed_response
 ```
@@ -315,10 +282,6 @@ WooCommerce.get('coupons', function(err, data, res) {
 print(wcapi.get("coupons").json())
 ```
 
-```php
-<?php print_r($woocommerce->coupons->get()); ?>
-```
-
 ```ruby
 woocommerce.get("coupons").parsed_response
 ```
@@ -450,18 +413,6 @@ data = {
 print(wcapi.put("coupons/529", data).json())
 ```
 
-```php
-<?php
-$data = array(
-	'coupon' => array(
-		'amount' => '5'
-	)
-);
-
-print_r($woocommerce->coupons->update(529, $data));
-?>
-```
-
 ```ruby
 data = {
   coupon: {
@@ -584,10 +535,6 @@ data = {
 print(wcapi.put("coupons/bulk", data).json())
 ```
 
-```php
-
-```
-
 ```ruby
 data = {
   coupons: [
@@ -718,10 +665,6 @@ WooCommerce.delete('coupons/529/?force=true', function(err, data, res) {
 print(wcapi.delete("coupons/529?force=true").json())
 ```
 
-```php
-<?php print_r($woocommerce->coupons->delete(529, true)); ?>
-```
-
 ```ruby
 woocommerce.delete("coupons/529?force=true").parsed_response
 ```
@@ -768,10 +711,6 @@ WooCommerce.get('coupons/count', function(err, data, res) {
 print(wcapi.get("coupons/count").json())
 ```
 
-```php
-<?php print_r($woocommerce->coupons->get_count()); ?>
-```
-
 ```ruby
 woocommerce.get("coupons/count").parsed_response
 ```
diff --git a/source/includes/v3/_customers.md b/source/includes/v3/_customers.md
index 6009fce6..1f143e8f 100644
--- a/source/includes/v3/_customers.md
+++ b/source/includes/v3/_customers.md
@@ -178,45 +178,6 @@ data = {
 print(wcapi.post("customers", data).json())
 ```
 
-```php
-<?php
-$data = array(
-    'customer' => array(
-        'email' => 'john.doe@example.com',
-        'first_name' => 'John',
-        'last_name' => 'Doe',
-        'username' => 'john.doe',
-        'billing_address' => array(
-            'first_name' => 'John',
-            'last_name' => 'Doe',
-            'company' => '',
-            'address_1' => '969 Market',
-            'address_2' => '',
-            'city' => 'San Francisco',
-            'state' => 'CA',
-            'postcode' => '94103',
-            'country' => 'US',
-            'email' => 'john.doe@example.com',
-            'phone' => '(555) 555-5555'
-        ),
-        'shipping_address' => array(
-            'first_name' => 'John',
-            'last_name' => 'Doe',
-            'company' => '',
-            'address_1' => '969 Market',
-            'address_2' => '',
-            'city' => 'San Francisco',
-            'state' => 'CA',
-            'postcode' => '94103',
-            'country' => 'US'
-        )
-    )
-);
-
-print_r($woocommerce->customers->create($data));
-?>
-```
-
 ```ruby
 data = {
   customer: {
@@ -333,10 +294,6 @@ WooCommerce.get('customers/2', function(err, data, res) {
 print(wcapi.get("customers/2").json())
 ```
 
-```php
-<?php print_r($woocommerce->customers->get(2)); ?>
-```
-
 ```ruby
 woocommerce.get("customers/2").parsed_response
 ```
@@ -413,10 +370,6 @@ WooCommerce.get('customers', function(err, data, res) {
 print(wcapi.get("customers").json())
 ```
 
-```php
-<?php print_r($woocommerce->customers->get()); ?>
-```
-
 ```ruby
 woocommerce.get("customers").parsed_response
 ```
@@ -574,24 +527,6 @@ data = {
 print(wcapi.put("customers/2", data).json())
 ```
 
-```php
-<?php
-$data = array(
-    'customer' => array(
-        'first_name' => 'James',
-        'billing_address' => array(
-            'first_name' => 'James'
-        ),
-        'shipping_address' => array(
-            'first_name' => 'James'
-        )
-    )
-);
-
-print_r($woocommerce->customers->update(2, $data));
-?>
-```
-
 ```ruby
 data = {
   customer: {
@@ -877,10 +812,6 @@ data = {
 print(wcapi.put("customers/bulk", data).json())
 ```
 
-```php
-
-```
-
 ```ruby
 data = {
   customers: [
@@ -1061,10 +992,6 @@ WooCommerce.delete('customers/2', function(err, data, res) {
 print(wcapi.delete("customers/2").json())
 ```
 
-```php
-<?php print_r($woocommerce->customers->delete(2)); ?>
-```
-
 ```ruby
 woocommerce.delete("customers/2").parsed_response
 ```
@@ -1105,10 +1032,6 @@ WooCommerce.get('customers/2/orders', function(err, data, res) {
 print(wcapi.get("customers/2/orders").json())
 ```
 
-```php
-<?php print_r($woocommerce->customers->get_orders(2)); ?>
-```
-
 ```ruby
 woocommerce.get("customers/2/orders").parsed_response
 ```
@@ -1270,10 +1193,6 @@ WooCommerce.get('customers/2/downloads', function(err, data, res) {
 print(wcapi.get("customers/2/downloads").json())
 ```
 
-```php
-<?php print_r($woocommerce->customers->get_downloads(2)); ?>
-```
-
 ```ruby
 woocommerce.get("customers/2/downloads").parsed_response
 ```
@@ -1343,10 +1262,6 @@ WooCommerce.get('customers/count', function(err, data, res) {
 print(wcapi.get("customers/count").json())
 ```
 
-```php
-<?php print_r($woocommerce->customers->get_count()); ?>
-```
-
 ```ruby
 woocommerce.get("customers/count").parsed_response
 ```
diff --git a/source/includes/v3/_index.md b/source/includes/v3/_index.md
index 7e6fc624..907563d0 100644
--- a/source/includes/v3/_index.md
+++ b/source/includes/v3/_index.md
@@ -73,10 +73,6 @@ WooCommerce.get('', function(err, data, res) {
 print(wcapi.get("").json())
 ```
 
-```php
-<?php print_r($woocommerce->index->get()); ?>
-```
-
 ```ruby
 woocommerce.get("").parsed_response
 ```
diff --git a/source/includes/v3/_introduction.md b/source/includes/v3/_introduction.md
index aa930949..d50339a1 100644
--- a/source/includes/v3/_introduction.md
+++ b/source/includes/v3/_introduction.md
@@ -431,7 +431,6 @@ See the webhook resource section.
 
 - [Node.js](https://www.npmjs.com/package/woocommerce-api)
 - [Python](https://pypi.python.org/pypi/WooCommerce)
-- [PHP](https://packagist.org/packages/woothemes/woocommerce-api)
 - [Ruby](https://rubygems.org/gems/woocommerce_api)
 
 ```javascript
@@ -464,22 +463,6 @@ wcapi = API(
 )
 ```
 
-```php
-<?php
-// Install:
-// composer require "woothemes/woocommerce-api:3.*"
-
-// Setup:
-include_once('vendor/autoload.php');
-
-$woocommerce = new WC_API_Client(
-    'http://example.com/',
-    'consumer_key',
-    'consumer_secret'
-);
-?>
-```
-
 ```ruby
 # Install:
 # gem install woocommerce_api
diff --git a/source/includes/v3/_orders.md b/source/includes/v3/_orders.md
index 8d683c9b..7b65e6a1 100644
--- a/source/includes/v3/_orders.md
+++ b/source/includes/v3/_orders.md
@@ -300,65 +300,6 @@ data = {
 print(wcapi.post("orders", data).json())
 ```
 
-```php
-<?php
-$data = array(
-    'order' => array(
-        'payment_details' => array(
-            'method_id' => 'bacs',
-            'method_title' => 'Direct Bank Transfer',
-            'paid' => true
-        ),
-        'billing_address' => array(
-            'first_name' => 'John',
-            'last_name' => 'Doe',
-            'address_1' => '969 Market',
-            'address_2' => '',
-            'city' => 'San Francisco',
-            'state' => 'CA',
-            'postcode' => '94103',
-            'country' => 'US',
-            'email' => 'john.doe@example.com',
-            'phone' => '(555) 555-5555'
-        ),
-        'shipping_address' => array(
-            'first_name' => 'John',
-            'last_name' => 'Doe',
-            'address_1' => '969 Market',
-            'address_2' => '',
-            'city' => 'San Francisco',
-            'state' => 'CA',
-            'postcode' => '94103',
-            'country' => 'US'
-        ),
-        'customer_id' => 2,
-        'line_items' => array(
-            array(
-                'product_id' => 546,
-                'quantity' => 2
-            ),
-            array(
-                'product_id' => 613,
-                'quantity' => 1,
-                'variations' => array(
-                    'pa_color' => 'Black'
-                )
-            )
-        ),
-        'shipping_lines' => array(
-            array(
-                'method_id' => 'flat_rate',
-                'method_title' => 'Flat Rate',
-                'total' => 10
-            )
-        )
-    )
-);
-
-print_r($woocommerce->orders->create($data));
-?>
-```
-
 ```ruby
 data = {
   order: {
@@ -604,10 +545,6 @@ WooCommerce.get('orders/645', function(err, data, res) {
 print(wcapi.get("orders/645").json())
 ```
 
-```php
-<?php print_r($woocommerce->orders->get(645)); ?>
-```
-
 ```ruby
 woocommerce.get("orders/645").parsed_response
 ```
@@ -800,10 +737,6 @@ WooCommerce.get('orders', function(err, data, res) {
 print(wcapi.get("orders").json())
 ```
 
-```php
-<?php print_r($woocommerce->orders->get()); ?>
-```
-
 ```ruby
 woocommerce.get("orders").parsed_response
 ```
@@ -1169,18 +1102,6 @@ data = {
 print(wcapi.put("orders/645", data).json())
 ```
 
-```php
-<?php
-$data = array(
-    'order' => array(
-        'status' => 'completed'
-    )
-);
-
-print_r($woocommerce->orders->update(645, $data));
-?>
-```
-
 ```ruby
 data = {
   order: {
@@ -1420,10 +1341,6 @@ data = {
 print(wcapi.put("orders/bulk", data).json())
 ```
 
-```php
-
-```
-
 ```ruby
 data = {
   orders: [
@@ -1778,9 +1695,6 @@ WooCommerce.delete('orders/645/?force=true', function(err, data, res) {
 print(wcapi.delete("orders/645/?force=true").json())
 ```
 
-```php
-<?php print_r($woocommerce->orders->delete(645, true)); ?>
-```
 
 ```ruby
 woocommerce.delete("orders/645/?force=true").parsed_response
@@ -1828,10 +1742,6 @@ WooCommerce.get('orders/count', function(err, data, res) {
 print(wcapi.get("orders/count").json())
 ```
 
-```php
-<?php print_r($woocommerce->orders->get_count()); ?>
-```
-
 ```ruby
 woocommerce.get("orders/count").parsed_response
 ```
@@ -1878,10 +1788,6 @@ WooCommerce.get('orders/statuses', function(err, data, res) {
 print(wcapi.get("orders/statuses").json())
 ```
 
-```php
-<?php print_r($woocommerce->orders->get_statuses()); ?>
-```
-
 ```ruby
 woocommerce.get("orders/statuses").parsed_response
 ```
@@ -1948,18 +1854,6 @@ data = {
 print(wcapi.post("orders/645/notes", data).json())
 ```
 
-```php
-<?php
-$data = array(
-    'order_note' => array(
-        'note' => 'Order ok!!!'
-    )
-);
-
-print_r($woocommerce->order_notes->create(645, $data));
-?>
-```
-
 ```ruby
 data = {
   order_note: {
@@ -2020,10 +1914,6 @@ WooCommerce.get('orders/645/notes/416', function(err, data, res) {
 print(wcapi.get("orders/645/notes/416").json())
 ```
 
-```php
-<?php print_r($woocommerce->order_notes->get(645, 416)); ?>
-```
-
 ```ruby
 woocommerce.get("orders/645/notes/416").parsed_response
 ```
@@ -2073,10 +1963,6 @@ WooCommerce.get('orders/645/notes', function(err, data, res) {
 print(wcapi.get("orders/645/notes").json())
 ```
 
-```php
-<?php print_r($woocommerce->order_notes->get(645)); ?>
-```
-
 ```ruby
 woocommerce.get("orders/645/notes").parsed_response
 ```
@@ -2164,18 +2050,6 @@ data = {
 print(wcapi.put("orders/645/notes/416", data).json())
 ```
 
-```php
-<?php
-$data = array(
-    'order_note' => array(
-        'note' => 'Ok!'
-    )
-);
-
-print_r($woocommerce->order_notes->update(645, 416, $data));
-?>
-```
-
 ```ruby
 data = {
   order_note: {
@@ -2231,10 +2105,6 @@ WooCommerce.delete('orders/645/notes/416', function(err, data, res) {
 print(wcapi.delete("orders/645/notes/416").json())
 ```
 
-```php
-<?php print_r($woocommerce->order_notes->delete(645, 416)); ?>
-```
-
 ```ruby
 woocommerce.delete("orders/645/notes/416").parsed_response
 ```
@@ -2293,18 +2163,6 @@ data = {
 print(wcapi.post("orders/645/refunds", data).json())
 ```
 
-```php
-<?php
-$data = array(
-    'order_refund' => array(
-        'amount' => 10
-    )
-);
-
-print_r($woocommerce->order_refunds->create(645, $data));
-?>
-```
-
 ```ruby
 data = {
   order_refund: {
@@ -2367,10 +2225,6 @@ WooCommerce.get('orders/645/refunds/649', function(err, data, res) {
 print(wcapi.get("orders/645/refunds/649").json())
 ```
 
-```php
-<?php print_r($woocommerce->order_refunds->get(645, 649)); ?>
-```
-
 ```ruby
 woocommerce.get("orders/645/refunds/649").parsed_response
 ```
@@ -2421,10 +2275,6 @@ WooCommerce.get('orders/645/refunds', function(err, data, res) {
 print(wcapi.get("orders/645/refunds").json())
 ```
 
-```php
-<?php print_r($woocommerce->order_refunds->get(645)); ?>
-```
-
 ```ruby
 woocommerce.get("orders/645/refunds").parsed_response
 ```
@@ -2531,18 +2381,6 @@ data = {
 print(wcapi.put("orders/645/refunds/649", data).json())
 ```
 
-```php
-<?php
-$data = array(
-    'order_refund' => array(
-        'reason' => 'Because was it necessary!'
-    )
-);
-
-print_r($woocommerce->order_refunds->update(645, 649, $data));
-?>
-```
-
 ```ruby
 data = {
   order_refund: {
@@ -2599,10 +2437,6 @@ WooCommerce.delete('orders/645/refunds/649', function(err, data, res) {
 print(wcapi.delete("orders/645/refunds/649").json())
 ```
 
-```php
-<?php print_r($woocommerce->order_refunds->delete(645, 649)); ?>
-```
-
 ```ruby
 woocommerce.delete("orders/645/refunds/649").parsed_response
 ```
diff --git a/source/includes/v3/_products.md b/source/includes/v3/_products.md
index ab0b5b35..be09062f 100644
--- a/source/includes/v3/_products.md
+++ b/source/includes/v3/_products.md
@@ -257,36 +257,6 @@ data = {
 print(wcapi.post("products", data).json())
 ```
 
-```php
-<?php
-$data = array(
-    'product' => array(
-        'title' => 'Premium Quality',
-        'type' => 'simple',
-        'regular_price' => '21.99',
-        'description' => 'Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.',
-        'short_description' => 'Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.',
-        'categories' => array(
-            9,
-            14
-        ),
-        'images' => array(
-            array(
-                'src' => 'http =>//example.com/wp-content/uploads/2015/01/premium-quality-front.jpg',
-                'position' => 0
-            ),
-            array(
-                'src' => 'http =>//example.com/wp-content/uploads/2015/01/premium-quality-back.jpg',
-                'position' => 1
-            )
-        )
-    )
-);
-
-print_r($woocommerce->products->create($data));
-?>
-```
-
 ```ruby
 data = {
   product: {
@@ -685,97 +655,6 @@ data = {
 print(wcapi.post("products", data).json())
 ```
 
-```php
-<?php
-$data = array(
-    'product' => array(
-        'title' => 'Ship Your Idea',
-        'type' => 'variable',
-        'description' => 'Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.',
-        'short_description' => 'Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.',
-        'categories' => array(
-            9,
-            14
-        ),
-        'images' => array(
-            array(
-                'src' => 'http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg',
-                'position' => 0
-            ),
-            array(
-                'src' => 'http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-back.jpg',
-                'position' => 1
-            ),
-            array(
-                'src' => 'http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg',
-                'position' => 2
-            ),
-            array(
-                'src' => 'http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-back.jpg',
-                'position' => 3
-            )
-        ),
-        'attributes' => array(
-            array(
-                'name' => 'Color',
-                'slug' => 'color',
-                'position' => '0',
-                'visible' => False,
-                'variation' => True,
-                'options' => array(
-                    'Black',
-                    'Green'
-                )
-            )
-        ),
-        'default_attributes' => array(
-            array(
-                'name' => 'Color',
-                'slug' => 'color',
-                'option' => 'Black'
-            )
-        ),
-        'variations' => array(
-            array(
-                'regular_price' => '19.99',
-                'image' => array(
-                    array(
-                        'src' => 'http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg',
-                        'position' => 0
-                    )
-                ),
-                'attributes' => array(
-                    array(
-                        'name' => 'Color',
-                        'slug' => 'color',
-                        'option' => 'black'
-                    )
-                )
-            ),
-            array(
-                'regular_price' => '19.99',
-                'image' => array(
-                    array(
-                        'src' => 'http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg',
-                        'position' => 0
-                    )
-                ),
-                'attributes' => array(
-                    array(
-                        'name' => 'Color',
-                        'slug' => 'color',
-                        'option' => 'green'
-                    )
-                )
-            )
-        )
-    )
-);
-
-print_r($woocommerce->products->create($data));
-?>
-```
-
 ```ruby
 data = {
   product: {
@@ -1126,10 +1005,6 @@ WooCommerce.get('products/546', function(err, data, res) {
 print(wcapi.get("products/546").json())
 ```
 
-```php
-<?php print_r($woocommerce->products->get(546)); ?>
-```
-
 ```ruby
 woocommerce.get("products/546").parsed_response
 ```
@@ -1260,10 +1135,6 @@ WooCommerce.get('products', function(err, data, res) {
 print(wcapi.get("products").json())
 ```
 
-```php
-<?php print_r($woocommerce->products->get()); ?>
-```
-
 ```ruby
 woocommerce.get("products").parsed_response
 ```
@@ -1648,18 +1519,6 @@ data = {
 print(wcapi.put("products/546", data).json())
 ```
 
-```php
-<?php
-$data = array(
-    'product' => array(
-        'regular_price': '24.54'
-    )
-);
-
-print_r($woocommerce->products->update(546, $data));
-?>
-```
-
 ```ruby
 data = {
   product: {
@@ -1864,10 +1723,6 @@ data = {
 print(wcapi.put("products/bulk", data).json())
 ```
 
-```php
-
-```
-
 ```ruby
 data = {
   products: [
@@ -2248,10 +2103,6 @@ WooCommerce.delete('products/546/?force=true', function(err, data, res) {
 print(wcapi.delete("products/546/?force=true").json())
 ```
 
-```php
-<?php print_r($woocommerce->products->delete(546, true)); ?>
-```
-
 ```ruby
 woocommerce.delete("products/546").parsed_response
 ```
@@ -2298,10 +2149,6 @@ WooCommerce.get('products/count', function(err, data, res) {
 print(wcapi.get("products/count").json())
 ```
 
-```php
-<?php print_r($woocommerce->products->get_count()); ?>
-```
-
 ```ruby
 woocommerce.get("products/count").parsed_response
 ```
@@ -2345,10 +2192,6 @@ WooCommerce.get('products/546/reviews', function(err, data, res) {
 print(wcapi.get("products/546/reviews").json())
 ```
 
-```php
-<?php print_r($woocommerce->products->get_reviews(546)); ?>
-```
-
 ```ruby
 woocommerce.get("products/546/reviews").parsed_response
 ```
@@ -2415,10 +2258,6 @@ WooCommerce.get('products/categories/9', function(err, data, res) {
 print(wcapi.get("products/categories/9").json())
 ```
 
-```php
-<?php print_r($woocommerce->products->get_categories(9)); ?>
-```
-
 ```ruby
 woocommerce.get("products/categories/9").parsed_response
 ```
@@ -2477,10 +2316,6 @@ WooCommerce.get('products/categories', function(err, data, res) {
 print(wcapi.get("products/categories").json())
 ```
 
-```php
-<?php print_r($woocommerce->products->get_categories()); ?>
-```
-
 ```ruby
 woocommerce.get("products/categories").parsed_response
 ```
diff --git a/source/includes/v3/_reports.md b/source/includes/v3/_reports.md
index c6f64975..d76a20ad 100644
--- a/source/includes/v3/_reports.md
+++ b/source/includes/v3/_reports.md
@@ -40,10 +40,6 @@ WooCommerce.get('reports', function(err, data, res) {
 print(wcapi.get("reports").json())
 ```
 
-```php
-<?php print_r($woocommerce->reports->get()); ?>
-```
-
 ```ruby
 woocommerce.get("reports").parsed_response
 ```
@@ -87,19 +83,6 @@ WooCommerce.get('reports/sales?filter[date_min]=2015-01-18&filter[date_max]=2015
 print(wcapi.get("reports/sales?filter[date_min]=2015-01-18&filter[date_max]=2015-01-21").json())
 ```
 
-```php
-<?php
-$args = array(
-	'filter' => array(
-		'date_min' => '2015-01-18',
-		'date_max' => '2015-01-21'
-	)
-);
-
-print_r($woocommerce->reports->get_sales($args));
-?>
-```
-
 ```ruby
 woocommerce.get("reports/sales?filter[date_min]=2015-01-18&filter[date_max]=2015-01-21").parsed_response
 ```
@@ -188,18 +171,6 @@ WooCommerce.get('reports/sales/top_sellers?filter[period]=last_month', function(
 print(wcapi.get("reports/sales/top_sellers?filter[period]=last_month").json())
 ```
 
-```php
-<?php
-$args = array(
-	'filter' => array(
-		'period' => 'last_month'
-	)
-);
-
-print_r($woocommerce->reports->get_top_sellers($args));
-?>
-```
-
 ```ruby
 woocommerce.get("reports/sales/top_sellers?filter[period]=last_month").parsed_response
 ```
diff --git a/source/includes/v3/_webhooks.md b/source/includes/v3/_webhooks.md
index e478bc0a..456f0954 100644
--- a/source/includes/v3/_webhooks.md
+++ b/source/includes/v3/_webhooks.md
@@ -103,21 +103,6 @@ data = {
 print(wcapi.post("webhooks", data).json())
 ```
 
-```php
-<?php
-$data = array(
-    'webhook' => array(
-        'name' => 'An add to cart webhook',
-        'secret' => 'my-super-secret-private-key',
-        'topic' => 'action.woocommerce_add_to_cart',
-        'delivery_url' => 'http://requestb.in/1exdwip1'
-    )
-);
-
-print_r($woocommerce->webhooks->create($data));
-?>
-```
-
 ```ruby
 data = {
   webhook: {
@@ -180,10 +165,6 @@ WooCommerce.get('webhooks/535', function(err, data, res) {
 print(wcapi.get("webhooks/535").json())
 ```
 
-```php
-<?php print_r($woocommerce->webhooks->get(535)); ?>
-```
-
 ```ruby
 woocommerce.get("webhooks/535").parsed_response
 ```
@@ -237,10 +218,6 @@ WooCommerce.get('webhooks', function(err, data, res) {
 print(wcapi.get("webhooks").json())
 ```
 
-```php
-<?php print_r($woocommerce->webhooks->get()); ?>
-```
-
 ```ruby
 woocommerce.get("webhooks").parsed_response
 ```
@@ -336,18 +313,6 @@ data = {
 print(wcapi.put("webhooks/535", data).json())
 ```
 
-```php
-<?php
-$data = array(
-    'webhook' => array(
-        'status' => 'paused'
-    )
-);
-
-print_r($woocommerce->webhooks->updaste(535, $data));
-?>
-```
-
 ```ruby
 data = {
   webhook: {
@@ -407,10 +372,6 @@ WooCommerce.delete('webhooks/535', function(err, data, res) {
 print(wcapi.delete("webhooks/535").json())
 ```
 
-```php
-<?php print_r($woocommerce->webhooks->delete(535)); ?>
-```
-
 ```ruby
 woocommerce.delete("webhooks/535").parsed_response
 ```
@@ -451,10 +412,6 @@ WooCommerce.get('webhooks/count', function(err, data, res) {
 print(wcapi.get("webhooks/count").json())
 ```
 
-```php
-<?php print_r($woocommerce->webhooks->get_count()); ?>
-```
-
 ```ruby
 woocommerce.get("webhooks/count").parsed_response
 ```
@@ -501,10 +458,6 @@ WooCommerce.get('webhooks/535/deliveries/378', function(err, data, res) {
 print(wcapi.get("webhooks/535/deliveries/378").json())
 ```
 
-```php
-<?php print_r($woocommerce->webhooks->get_deliveries(378)); ?>
-```
-
 ```ruby
 woocommerce.get("webhooks/535/deliveries/378").parsed_response
 ```
@@ -579,10 +532,6 @@ WooCommerce.get('webhooks/535/deliveries', function(err, data, res) {
 print(wcapi.get("webhooks/535/deliveries").json())
 ```
 
-```php
-<?php print_r($woocommerce->webhooks->get_deliveries()); ?>
-```
-
 ```ruby
 woocommerce.get("webhooks/535/deliveries").parsed_response
 ```
diff --git a/source/index.md b/source/index.md
index b83512e1..29d25048 100644
--- a/source/index.md
+++ b/source/index.md
@@ -5,7 +5,6 @@ language_tabs:
   - shell: cURL
   - javascript: Node.js
   - python: Python
-  - php: PHP
   - ruby: Ruby
 
 toc_footers:

From dd1974e258bfebf99330fb29a37bc5e26509e1bb Mon Sep 17 00:00:00 2001
From: Claudio Sanches <contato@claudiosmweb.com>
Date: Mon, 10 Aug 2015 14:08:05 -0300
Subject: [PATCH 16/18] Removed old tip about wrong implementation of OAuth 1.0
 fixed on rest api v3

---
 source/includes/v3/_introduction.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/source/includes/v3/_introduction.md b/source/includes/v3/_introduction.md
index d50339a1..75815f8f 100644
--- a/source/includes/v3/_introduction.md
+++ b/source/includes/v3/_introduction.md
@@ -145,7 +145,6 @@ If you are having trouble generating a correct signature, you'll want to review
 * The OAuth nonce can be any randomly generated 32 character (recommended) string that is unique to the consumer key. Read more suggestions on [generating a nonce](https://dev.twitter.com/discussions/12445) on the Twitter API forums.
 * The OAuth timestamp should be the unix timestamp at the time of the request. The API will deny any requests that include a timestamp that is outside of a 15 minute window to prevent replay attacks.
 * You must use the store URL provided by the index when forming the base string used for the signature, as this is what the server will use. (e.g. if the store URL includes a `www` sub-domain, you should use it for requests)
-* Some OAuth libraries add an ampersand to the provided secret key before generating the signature. WooCommerce does *not* adhere to the OAuth spec in this regard and the ampersand should be removed prior to generating the signature. An ampersand at the end of the string will result in an invalid signature.
 * You may test your generated signature using LinkedIn's [OAuth test console](http://developer.linkedinlabs.com/oauth-test/) -- leave the member token/secret blank.
 * Twitter has great instructions on [generating a signature](https://dev.twitter.com/docs/auth/creating-signature) with OAuth 1.0a, but remember tokens are not used with this implementation.
 * Note that the request body is *not* signed as per the OAuth spec, see [Google's OAuth 1.0 extension](https://oauth.googlecode.com/svn/spec/ext/body_hash/1.0/oauth-bodyhash.html) for details on why.

From ec565cb18043b89978ae7dfb0b514d4f81e14a95 Mon Sep 17 00:00:00 2001
From: Claudio Sanches <contato@claudiosmweb.com>
Date: Mon, 10 Aug 2015 14:16:11 -0300
Subject: [PATCH 17/18] Added docs about products/<id>/orders

---
 source/includes/v3/_products.md | 341 ++++++++++++++++++++++++++++++++
 1 file changed, 341 insertions(+)

diff --git a/source/includes/v3/_products.md b/source/includes/v3/_products.md
index be09062f..b4bdcc96 100644
--- a/source/includes/v3/_products.md
+++ b/source/includes/v3/_products.md
@@ -2402,3 +2402,344 @@ woocommerce.get("products/categories").parsed_response
 <aside class="notice">
 	View the <a href="#product-category-properties">Product Category Properties</a> for more details on this response.
 </aside>
+
+## View List Of Product Orders ##
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v3/products/&lt;id&gt;/orders</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v3/products/546/orders \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('products/546/orders', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("products/546/orders").json())
+```
+
+```ruby
+woocommerce.get("products/546/orders").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "orders": [
+    {
+      "id": 645,
+      "order_number": 645,
+      "created_at": "2015-01-26T20:00:21Z",
+      "updated_at": "2015-07-31T11:45:12Z",
+      "completed_at": "2015-01-26T20:00:21Z",
+      "status": "processing",
+      "currency": "USD",
+      "total": "79.87",
+      "subtotal": "63.97",
+      "total_line_items_quantity": 3,
+      "total_tax": "5.90",
+      "total_shipping": "10.00",
+      "cart_tax": "5.40",
+      "shipping_tax": "0.50",
+      "total_discount": "0.00",
+      "shipping_methods": "Local Delivery",
+      "payment_details": {
+        "method_id": "bacs",
+        "method_title": "Direct Bank Transfer",
+        "paid": true
+      },
+      "billing_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US",
+        "email": "john.doe@example.com",
+        "phone": "(555) 555-5555"
+      },
+      "shipping_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US"
+      },
+      "note": "",
+      "customer_ip": "127.0.0.1",
+      "customer_user_agent": "WordPress/4.1; http://example.com",
+      "customer_id": 2,
+      "view_order_url": "https://example.com/my-account/view-order/645",
+      "line_items": [
+        {
+          "id": 504,
+          "subtotal": "43.98",
+          "subtotal_tax": "4.40",
+          "total": "43.98",
+          "total_tax": "4.40",
+          "price": "21.99",
+          "quantity": 2,
+          "tax_class": "reduced-rate",
+          "name": "Premium Quality",
+          "product_id": 546,
+          "sku": "",
+          "meta": []
+        },
+        {
+          "id": 505,
+          "subtotal": "19.99",
+          "subtotal_tax": "1.00",
+          "total": "19.99",
+          "total_tax": "1.00",
+          "price": "19.99",
+          "quantity": 1,
+          "tax_class": null,
+          "name": "Ship Your Idea",
+          "product_id": 613,
+          "sku": "",
+          "meta": [
+            {
+              "key": "pa_color",
+              "label": "Color",
+              "value": "Black"
+            }
+          ]
+        }
+      ],
+      "shipping_lines": [
+        {
+          "id": 506,
+          "method_id": "flat_rate",
+          "method_title": "Local Delivery",
+          "total": "10.00"
+        }
+      ],
+      "tax_lines": [
+        {
+          "id": 507,
+          "rate_id": "5",
+          "code": "US-CA-TAX-1",
+          "title": "Tax",
+          "total": "4.40",
+          "compound": false
+        },
+        {
+          "id": 508,
+          "rate_id": "4",
+          "code": "US-STANDARD-1",
+          "title": "Standard",
+          "total": "1.50",
+          "compound": false
+        }
+      ],
+      "fee_lines": [],
+      "coupon_lines": [],
+      "customer": {
+        "id": 2,
+        "created_at": "2014-11-19T18:34:19Z",
+        "email": "john.doe@example.com",
+        "first_name": "",
+        "last_name": "",
+        "username": "john.doe",
+        "last_order_id": "645",
+        "last_order_date": "2015-01-26T20:00:21Z",
+        "orders_count": 2,
+        "total_spent": "19.00",
+        "avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
+        "billing_address": {
+          "first_name": "John",
+          "last_name": "Doe",
+          "company": "",
+          "address_1": "969 Market",
+          "address_2": "",
+          "city": "San Francisco",
+          "state": "CA",
+          "postcode": "94103",
+          "country": "US",
+          "email": "john.doe@example.com",
+          "phone": "(555) 555-5555"
+        },
+        "shipping_address": {
+          "first_name": "John",
+          "last_name": "Doe",
+          "company": "",
+          "address_1": "969 Market",
+          "address_2": "",
+          "city": "San Francisco",
+          "state": "CA",
+          "postcode": "94103",
+          "country": "US"
+        }
+      }
+    },
+    {
+      "id": 644,
+      "order_number": 644,
+      "created_at": "2015-01-26T19:33:42Z",
+      "updated_at": "2015-07-31T11:45:12Z",
+      "completed_at": "2015-01-26T19:33:42Z",
+      "status": "on-hold",
+      "currency": "USD",
+      "total": "44.14",
+      "subtotal": "30.99",
+      "total_line_items_quantity": 2,
+      "total_tax": "3.15",
+      "total_shipping": "10.00",
+      "cart_tax": "2.65",
+      "shipping_tax": "0.50",
+      "total_discount": "0.00",
+      "shipping_methods": "Flat Rate",
+      "payment_details": {
+        "method_id": "bacs",
+        "method_title": "Direct Bank Transfer",
+        "paid": false
+      },
+      "billing_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US",
+        "email": "john.doe@example.com",
+        "phone": "(555) 555-5555"
+      },
+      "shipping_address": {
+        "first_name": "John",
+        "last_name": "Doe",
+        "company": "",
+        "address_1": "969 Market",
+        "address_2": "",
+        "city": "San Francisco",
+        "state": "CA",
+        "postcode": "94103",
+        "country": "US"
+      },
+      "note": "",
+      "customer_ip": "127.0.0.1",
+      "customer_user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/40.0.2214.91 Safari/537.36",
+      "customer_id": 2,
+      "view_order_url": "https://example.com/my-account/view-order/644",
+      "line_items": [
+        {
+          "id": 499,
+          "subtotal": "21.99",
+          "subtotal_tax": "2.20",
+          "total": "21.99",
+          "total_tax": "2.20",
+          "price": "21.99",
+          "quantity": 1,
+          "tax_class": "reduced-rate",
+          "name": "Premium Quality",
+          "product_id": 546,
+          "sku": "",
+          "meta": []
+        },
+        {
+          "id": 500,
+          "subtotal": "9.00",
+          "subtotal_tax": "0.45",
+          "total": "9.00",
+          "total_tax": "0.45",
+          "price": "9.00",
+          "quantity": 1,
+          "tax_class": null,
+          "name": "Woo Album #4",
+          "product_id": 96,
+          "sku": "",
+          "meta": []
+        }
+      ],
+      "shipping_lines": [
+        {
+          "id": 501,
+          "method_id": "flat_rate",
+          "method_title": "Flat Rate",
+          "total": "10.00"
+        }
+      ],
+      "tax_lines": [
+        {
+          "id": 502,
+          "rate_id": "5",
+          "code": "US-CA-TAX-1",
+          "title": "Tax",
+          "total": "4.40",
+          "compound": false
+        },
+        {
+          "id": 503,
+          "rate_id": "4",
+          "code": "US-STANDARD-1",
+          "title": "Standard",
+          "total": "1.50",
+          "compound": false
+        }
+      ],
+      "fee_lines": [],
+      "coupon_lines": [],
+      "customer": {
+        "id": 2,
+        "created_at": "2014-11-19T18:34:19Z",
+        "email": "john.doe@example.com",
+        "first_name": "",
+        "last_name": "",
+        "username": "john.doe",
+        "last_order_id": "645",
+        "last_order_date": "2015-01-26T20:00:21Z",
+        "orders_count": 2,
+        "total_spent": "19.00",
+        "avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
+        "billing_address": {
+          "first_name": "John",
+          "last_name": "Doe",
+          "company": "",
+          "address_1": "969 Market",
+          "address_2": "",
+          "city": "San Francisco",
+          "state": "CA",
+          "postcode": "94103",
+          "country": "US",
+          "email": "john.doe@example.com",
+          "phone": "(555) 555-5555"
+        },
+        "shipping_address": {
+          "first_name": "John",
+          "last_name": "Doe",
+          "company": "",
+          "address_1": "969 Market",
+          "address_2": "",
+          "city": "San Francisco",
+          "state": "CA",
+          "postcode": "94103",
+          "country": "US"
+        }
+      }
+    }
+  ]
+}
+```
+
+<aside class="notice">
+	View the <a href="#orders-properties">Order Properties</a> for more details on this response.
+</aside>

From 1d1b07cd546361616a6a8df8c141a7e81651cc2c Mon Sep 17 00:00:00 2001
From: Claudio Sanches <contato@claudiosmweb.com>
Date: Mon, 10 Aug 2015 15:20:36 -0300
Subject: [PATCH 18/18] Created docs for product attributes

---
 source/includes/v3/_products.md | 404 +++++++++++++++++++++++++++++---
 1 file changed, 368 insertions(+), 36 deletions(-)

diff --git a/source/includes/v3/_products.md b/source/includes/v3/_products.md
index b4bdcc96..cd5f6cc9 100644
--- a/source/includes/v3/_products.md
+++ b/source/includes/v3/_products.md
@@ -979,7 +979,7 @@ woocommerce.post("products", data).parsed_response
 
 ## View A Product ##
 
-This API lets you retrieve and view a specific product by ID or sku.
+This API lets you retrieve and view a specific product by ID.
 
 ### HTTP Request ###
 
@@ -2089,22 +2089,22 @@ This API helps you delete a product.
 </div>
 
 ```shell
-curl -X DELETE https://example.com/wc-api/v3/products/546/?force=true \
+curl -X DELETE https://example.com/wc-api/v3/products/546?force=true \
 	-u consumer_key:consumer_secret
 ```
 
 ```javascript
-WooCommerce.delete('products/546/?force=true', function(err, data, res) {
+WooCommerce.delete('products/546?force=true', function(err, data, res) {
   console.log(res);
 });
 ```
 
 ```python
-print(wcapi.delete("products/546/?force=true").json())
+print(wcapi.delete("products/546?force=true").json())
 ```
 
 ```ruby
-woocommerce.delete("products/546").parsed_response
+woocommerce.delete("products/546?force=true").parsed_response
 ```
 
 > JSON response example:
@@ -2168,74 +2168,333 @@ woocommerce.get("products/count").parsed_response
 | `type`     | string | Products by type. eg: `simple` or `variable` |
 | `category` | string | Products by category.                        |
 
-## View List Of Product Reviews ##
+## Create A Product Attribute ##
+
+This API helps you to create a new product attribute.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-post">POST</i>
+		<h6>/wc-api/v3/products/attributes</h6>
+	</div>
+</div>
+
+```shell
+curl -X POST https://example.com/wc-api/v3/products/attributes \
+    -u consumer_key:consumer_secret \
+    -H "Content-Type: application/json" \
+    -d '{
+  "product_attribute": {
+    "name": "Color",
+    "slug": "pa_color",
+    "type": "select",
+    "order_by": "menu_order",
+    "has_archives": true
+  }
+}'
+```
+
+```javascript
+var data = {
+  product_attribute: {
+    name: "Color",
+    slug: "pa_color",
+    type: "select",
+    order_by: "menu_order",
+    has_archives: true
+  }
+};
+
+WooCommerce.post('products/attributes', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "product_attribute": {
+        "name": "Color",
+        "slug": "pa_color",
+        "type": "select",
+        "order_by": "menu_order",
+        "has_archives": True
+    }
+}
+
+print(wcapi.post("products/attributes", data).json())
+```
+
+```ruby
+data = {
+  product_attribute: {
+    name: "Color",
+    slug: "pa_color",
+    type: "select",
+    order_by: "menu_order",
+    has_archives: true
+  }
+}
+
+woocommerce.post("products/attributes", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "product_attribute": {
+    "id": 1,
+    "name": "Color",
+    "slug": "pa_color",
+    "type": "select",
+    "order_by": "menu_order",
+    "has_archives": true
+  }
+}
+```
+
+### Product Attribute Properties ###
+
+|   Attribute    |   Type  |                                                     Description                                                      |
+| -------------- | ------- | -------------------------------------------------------------------------------------------------------------------- |
+| `id`           | integer | Attribute ID <i class="label label-info">read-only</i>                                                               |
+| `name`         | string  | Attribute name                                                                                                       |
+| `slug`         | string  | Attribute slug                                                                                                       |
+| `type`         | string  | Attribute type, the types available include by default are: `select` and `text` (some plugins can include new types) |
+| `order_by`     | string  | Default sort order. Available: `menu_order`, `name`, `name_num` and `id`                                             |
+| `has_archives` | boolean | Enable/Disable attribute archives                                                                                    |
+
+## View A Product Attribute ##
+
+This API lets you retrieve and view a specific product attribute by ID.
 
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
-		<h6>/wc-api/v3/products/&lt;id&gt;/reviews</h6>
+		<h6>/wc-api/v3/products/attributes/&lt;id&gt;</h6>
 	</div>
 </div>
 
 ```shell
-curl https://example.com/wc-api/v3/products/546/reviews \
+curl https://example.com/wc-api/v3/products/attributes/1 \
 	-u consumer_key:consumer_secret
 ```
 
 ```javascript
-WooCommerce.get('products/546/reviews', function(err, data, res) {
+WooCommerce.get('products/attributes/1', function(err, data, res) {
   console.log(res);
 });
 ```
 
 ```python
-print(wcapi.get("products/546/reviews").json())
+print(wcapi.get("products/attributes/1").json())
 ```
 
 ```ruby
-woocommerce.get("products/546/reviews").parsed_response
+woocommerce.get("products/attributes/1").parsed_response
 ```
 
 > JSON response example:
 
 ```json
 {
-  "product_reviews": [
+  "product_attribute": {
+    "id": 1,
+    "name": "Color",
+    "slug": "pa_color",
+    "type": "select",
+    "order_by": "menu_order",
+    "has_archives": true
+  }
+}
+```
+
+<aside class="notice">
+	View the <a href="#product-attribute-properties">Product Attribute Properties</a> for more details on this response.
+</aside>
+
+## View List Of Product Attributes ##
+
+This API helps you to view all the product attributes.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v3/products/attributes</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v3/products/attributes \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('products/attributes', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("products/attributes").json())
+```
+
+```ruby
+woocommerce.get("products/attributes").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "product_attributes": [
     {
-      "id": 4,
-      "created_at": "2013-06-07T11:57:45Z",
-      "review": "This t-shirt is awesome! Would recommend to everyone!\n\nI'm ordering mine next week",
-      "rating": "5",
-      "reviewer_name": "Andrew",
-      "reviewer_email": "andrew@example.com",
-      "verified": false
+      "id": 1,
+      "name": "Color",
+      "slug": "pa_color",
+      "type": "select",
+      "order_by": "menu_order",
+      "has_archives": true
     },
     {
-      "id": 3,
-      "created_at": "2013-06-07T11:53:49Z",
-      "review": "Wonderful quality, and an awesome design. WooThemes ftw!",
-      "rating": "4",
-      "reviewer_name": "Cobus Bester",
-      "reviewer_email": "cobus@example.com",
-      "verified": false
+      "id": 2,
+      "name": "Size",
+      "slug": "pa_size",
+      "type": "select",
+      "order_by": "menu_order",
+      "has_archives": false
     }
   ]
 }
 ```
 
-### Product Reviews Properties ###
+<aside class="notice">
+	View the <a href="#product-attribute-properties">Product Attribute Properties</a> for more details on this response.
+</aside>
 
-|    Attribute     |   Type  |                                        Description                                        |
-| ---------------- | ------- | ----------------------------------------------------------------------------------------- |
-| `id`             | integer | Review ID (comment ID) <i class="label label-info">read-only</i>                          |
-| `created_at`     | string  | UTC DateTime when the review was created <i class="label label-info">read-only</i>        |
-| `rating`         | string  | Review rating (0 to 5) <i class="label label-info">read-only</i>                          |
-| `reviewer_name`  | string  | Reviewer name <i class="label label-info">read-only</i>                                   |
-| `reviewer_email` | string  | Reviewer email <i class="label label-info">read-only</i>                                  |
-| `verified`       | boolean | Shows if the reviewer bought the product or not <i class="label label-info">read-only</i> |
+## Update A Product Attribute ##
+
+This API lets you make changes to a product attribute.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-put">PUT</i>
+		<h6>/wc-api/v3/products/attributes/&lt;id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl -X PUT https://example.com/wc-api/v3/products/attributes/1 \
+	-u consumer_key:consumer_secret \
+	-H "Content-Type: application/json" \
+	-d '{
+  "product_attribute": {
+    "order_by": "name"
+  }
+}'
+```
+
+```javascript
+var data = {
+  product_attribute: {
+    order_by: 'name'
+  }
+};
+
+WooCommerce.put('products/attributes/1', data, function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+data = {
+    "product_attribute": {
+        "order_by": "name"
+    }
+}
+
+print(wcapi.put("products/attributes/1", data).json())
+```
+
+```ruby
+data = {
+  product_attribute: {
+    order_by: "name"
+  }
+}
+
+woocommerce.put("products/attributes/1", data).parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "product_attribute": {
+    "id": 1,
+    "name": "Color",
+    "slug": "pa_color",
+    "type": "select",
+    "order_by": "name",
+    "has_archives": true
+  }
+}
+```
+
+<aside class="notice">
+	View the <a href="#product-attribute-properties">Product Attribute Properties</a> for more details on this response.
+</aside>
+
+## Delete A Product Attribute ##
+
+This API helps you delete a product attribute.
+
+### HTTP Request ###
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-delete">DELETE</i>
+		<h6>/wc-api/v3/products/attributes/&lt;id&gt;</h6>
+	</div>
+</div>
+
+```shell
+curl -X DELETE https://example.com/wc-api/v3/products/attributes/1 \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.delete('products/attributes/1', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.delete("products/attributes/1").json())
+```
+
+```ruby
+woocommerce.delete("products/attributes/1").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "message": "Deleted product_attribute"
+}
+```
 
 ## View A Product Category ##
 
+This API lets you retrieve a product category.
+
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
@@ -2284,7 +2543,7 @@ woocommerce.get("products/categories/9").parsed_response
 |   Attribute   |   Type  |                                                                       Description                                                                       |
 | ------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `id`          | integer | Category ID (term ID) <i class="label label-info">read-only</i>                                                                                         |
-| `name`        | string  | Category Name <i class="label label-info">read-only</i>                                                                                                 |
+| `name`        | string  | Category name <i class="label label-info">read-only</i>                                                                                                 |
 | `slug`        | string  | Category slug <i class="label label-info">read-only</i>                                                                                                 |
 | `parent`      | integer | Category parent <i class="label label-info">read-only</i>                                                                                               |
 | `description` | string  | Category description <i class="label label-info">read-only</i>                                                                                          |
@@ -2292,8 +2551,11 @@ woocommerce.get("products/categories/9").parsed_response
 | `image`       | string  | Category image URL <i class="label label-info">read-only</i>                                                                                            |
 | `count`       | boolean | Shows the quantity of products in this category <i class="label label-info">read-only</i>                                                               |
 
+
 ## View List Of Product Categories ##
 
+This API lets you retrieve all product categories.
+
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
@@ -2405,6 +2667,8 @@ woocommerce.get("products/categories").parsed_response
 
 ## View List Of Product Orders ##
 
+This API lets you retrieve all product orders.
+
 <div class="api-endpoint">
 	<div class="endpoint-data">
 		<i class="label label-get">GET</i>
@@ -2743,3 +3007,71 @@ woocommerce.get("products/546/orders").parsed_response
 <aside class="notice">
 	View the <a href="#orders-properties">Order Properties</a> for more details on this response.
 </aside>
+
+## View List Of Product Reviews ##
+
+This API lets you retrieve all reviews of a product.
+
+<div class="api-endpoint">
+	<div class="endpoint-data">
+		<i class="label label-get">GET</i>
+		<h6>/wc-api/v3/products/&lt;id&gt;/reviews</h6>
+	</div>
+</div>
+
+```shell
+curl https://example.com/wc-api/v3/products/546/reviews \
+	-u consumer_key:consumer_secret
+```
+
+```javascript
+WooCommerce.get('products/546/reviews', function(err, data, res) {
+  console.log(res);
+});
+```
+
+```python
+print(wcapi.get("products/546/reviews").json())
+```
+
+```ruby
+woocommerce.get("products/546/reviews").parsed_response
+```
+
+> JSON response example:
+
+```json
+{
+  "product_reviews": [
+    {
+      "id": 4,
+      "created_at": "2013-06-07T11:57:45Z",
+      "review": "This t-shirt is awesome! Would recommend to everyone!\n\nI'm ordering mine next week",
+      "rating": "5",
+      "reviewer_name": "Andrew",
+      "reviewer_email": "andrew@example.com",
+      "verified": false
+    },
+    {
+      "id": 3,
+      "created_at": "2013-06-07T11:53:49Z",
+      "review": "Wonderful quality, and an awesome design. WooThemes ftw!",
+      "rating": "4",
+      "reviewer_name": "Cobus Bester",
+      "reviewer_email": "cobus@example.com",
+      "verified": false
+    }
+  ]
+}
+```
+
+### Product Reviews Properties ###
+
+|    Attribute     |   Type  |                                        Description                                        |
+| ---------------- | ------- | ----------------------------------------------------------------------------------------- |
+| `id`             | integer | Review ID (comment ID) <i class="label label-info">read-only</i>                          |
+| `created_at`     | string  | UTC DateTime when the review was created <i class="label label-info">read-only</i>        |
+| `rating`         | string  | Review rating (0 to 5) <i class="label label-info">read-only</i>                          |
+| `reviewer_name`  | string  | Reviewer name <i class="label label-info">read-only</i>                                   |
+| `reviewer_email` | string  | Reviewer email <i class="label label-info">read-only</i>                                  |
+| `verified`       | boolean | Shows if the reviewer bought the product or not <i class="label label-info">read-only</i> |