From ee904d78f4df97e46c3aba5bc9fe87be2ade57c5 Mon Sep 17 00:00:00 2001
From: tim <tim@ascribe.io>
Date: Wed, 16 Nov 2016 16:01:16 +0100
Subject: [PATCH] Add transactions by asset id endpoint

---
 .../http-client-server-api.rst                | 52 ++++++++++++++++++-
 1 file changed, 51 insertions(+), 1 deletion(-)

diff --git a/docs/server/source/drivers-clients/http-client-server-api.rst b/docs/server/source/drivers-clients/http-client-server-api.rst
index 69b8b7a3..abdff476 100644
--- a/docs/server/source/drivers-clients/http-client-server-api.rst
+++ b/docs/server/source/drivers-clients/http-client-server-api.rst
@@ -179,8 +179,58 @@ Transactions
    :statuscode 200: A list of transaction's containing unfulfilled conditions was found and returned.
    :statuscode 400: The request wasn't understood by the server, e.g. the ``owners_after`` querystring was not included in the request.
 
+.. http:get:: /transactions?fields=id,asset,operation&operation={CREATE|TRANSFER}&asset_id={asset_id}
 
-.. http:post:: /transactions/
+   Get a list of transactions that use an asset with the ID ``asset_id``.
+
+   This endpoint will return a ``HTTP 400 Bad Request`` if the querystring
+   ``asset_id`` happens to not be defined in the request.
+
+   ``operation`` can either be ``GENESIS``, ``CREATE`` or ``TRANSFER``.
+
+   This endpoint returns assets only if the transaction they're in are
+   included in a ``VALID`` or ``UNDECIDED`` block on ``bigchain``.
+
+   :param fields: A comma separated string to expand properties on the transaction object to be returned.
+   :type fields: string
+
+   :param operation: One of the three supported operations of a transaction.
+   :type operation: string
+
+   :param asset_id: asset ID.
+   :type asset_id: uuidv4
+
+   **Example request**:
+
+   .. sourcecode:: http
+
+      GET /transactions?fields=id,asset,operation&operation=CREATE&asset_id=1AAAbbb...ccc HTTP/1.1
+      Host: example.com
+
+   **Example response**:
+
+   .. sourcecode:: http
+
+      HTTP/1.1 200 OK
+      Content-Type: application/json
+
+      [{
+        "transaction": {
+          "asset": {
+            "divisible": false,
+            "updatable": false,
+            "data": null,
+            "id": "1AAAbbb...ccc",
+            "refillable": false
+          },
+        "operation": "CREATE",
+        "id": "2d431073e1477f3073a4693ac7ff9be5634751de1b8abaa1f4e19548ef0b4b0e",
+      }]
+
+   :statuscode 200: A list of transaction's containing an asset with ID ``asset_id`` was found and returned.
+   :statuscode 400: The request wasn't understood by the server, e.g. the ``asset_id`` querystring was not included in the request.
+
+.. http:post:: /transactions
 
    Push a new transaction.