From 275f29cfe4f3292f16a83dbd53023d05a45bd32b Mon Sep 17 00:00:00 2001
From: tim <tim@ascribe.io>
Date: Wed, 14 Jun 2017 17:05:47 +0200
Subject: [PATCH] Add note for polling and WS API when POST /transactions

---
 docs/server/source/http-client-server-api.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/server/source/http-client-server-api.rst b/docs/server/source/http-client-server-api.rst
index f333e5fa..2fccd955 100644
--- a/docs/server/source/http-client-server-api.rst
+++ b/docs/server/source/http-client-server-api.rst
@@ -147,6 +147,14 @@ Transactions
    .. literalinclude:: http-samples/post-tx-response.http
       :language: http
 
+   .. note::
+       If the server is returning a ``202`` HTTP status code, then the
+       transaction has been accepted for processing. To check the status of the
+       transaction, poll the link to the `status monitor
+       <https://docs.bigchaindb.com/projects/server/en/latest/http-client-server-api.html#get--api-v1-statuses?tx_id=tx_id>`_
+       provided in the ``Location`` header or listen to server's
+       :ref:`WebSocket Event Stream API <The WebSocket Event Stream API>`.
+
    :resheader Content-Type: ``application/json``
    :resheader Location: Relative link to a status monitor for the submitted transaction.