1 files changed, 81 insertions, 5 deletions
diff --git a/docs/sections/apis/PMSH.rst b/docs/sections/apis/PMSH.rst
index 221c3c13..019e4ce9 100644
--- a/docs/sections/apis/PMSH.rst
+++ b/docs/sections/apis/PMSH.rst
@@ -15,9 +15,86 @@ Component description can be found under `PM Subscription Handler`_.
 
 .. _PM Subscription Handler: ../../sections/services/pm-subscription-handler/index.html
 
+.. csv-table::
+   :header: "API name", "Swagger JSON", "Swagger YAML"
+   :widths: 10,5,5
+
+   "PM Subscription Handler Service", ":download:`link <pmsh_swagger.json>`", ":download:`link <pmsh_swagger.yaml>`"
+
 Paths
 =====
 
+GET ``/subscriptions``
+----------------------
+
+Description
+~~~~~~~~~~~
+Retrieves all defined Subscriptions and their related Network Functions from ONAP.
+
+Responses
+~~~~~~~~~
+
+**200**
+^^^^^^^
+
+The Subscription details are returned successfully
+
+**Example:**
+
+.. code-block:: javascript
+
+   [
+     {
+       "network_functions": [
+         {
+           "nf_name": "pnf102",
+           "nf_sub_status": "PENDING_CREATE",
+           "orchestration_status": "Active"
+         },
+         {
+           "nf_name": "vnf101",
+           "nf_sub_status": "CREATED",
+           "orchestration_status": "Active"
+         }
+       ],
+       "subscription_name": "demo-subscription",
+       "subscription_status": "UNLOCKED"
+     }
+   ]
+
+The subscription_status refers to the administrative status of the subscription.
+
+.. csv-table:: Potential Values
+   :header: "Status", "Description"
+   :widths: 2,4
+
+   LOCKED, The Subscription is un-deploying / inactive.
+   UNLOCKED, The Subscription is deployed / active.
+
+
+The network_functions.orchestration_status refers to the status of the xNF in AAI ONAP.
+
+.. csv-table:: Potential Values
+   :header: "Status", "Description"
+   :widths: 4,18
+
+   Inventoried, The xNF has been on-boarded in ONAP but not yet operable.
+   Active, The xNF is active and contactable.
+
+
+The network_functions.nf_sub_status refers to the status of the subscription (PM Job) on the xNF.
+
+.. csv-table:: Potential Values
+   :header: "Status", "Description"
+   :widths: 5,16
+
+    PENDING_CREATE, Create event published to Policy topic. Awaiting response.
+    CREATE_FAILED, Subscription failed to be created on the xNF.
+    CREATED, Subscription created successfully on the xNF.
+    PENDING_DELETE, Delete event published to Poilcy topic. Awaiting response.
+    DELETE_FAILED, Subscription deletion failed to be applied on the xNF.
+
+
 GET ``/healthcheck``
 --------------------
 
@@ -29,8 +106,7 @@ If anything other than a 200, the server is either dead or no connection to PMSH
 Responses
 ~~~~~~~~~
 
-+-----------+---------------------+
-| HTTP Code | Description         |
-+===========+=====================+
-| **200**   | successful response |
-+-----------+---------------------+
+**200**
+^^^^^^^
+
+The PMSH instance is running