diff --git a/docs/api.apib b/docs/api.apib
index 90e0782dd..80280cfe8 100644
--- a/docs/api.apib
+++ b/docs/api.apib
@@ -380,11 +380,11 @@ This request will commit all changes and close the given session (security_signo
 
             <!-- include(session/error-response_schema.json) -->
 
-## Remarks [/remarks]
+## Remarks [/remarks/]
 
-### Remarks [GET /remarks/{recordLocator}]
+### Remarks [GET /remarks?recordLocator={recordLocator}]
 
-This request will return all remarks for given recordLocator and officeId
+This request will return all remarks for given recordLocator and officeId.
 
 + Parameters
 
@@ -424,7 +424,7 @@ This request will return all remarks for given recordLocator and officeId
 
             <!-- include(remarks/error-response_schema.json) -->
 
-### Remarks [POST /remarks]
+### Remarks [POST /remarks/]
 
 This request will add the given remarks, return all remarks for given recordLocator and officeId
 
@@ -467,7 +467,7 @@ This request will add the given remarks, return all remarks for given recordLoca
 
             <!-- include(remarks/error-response_schema.json) -->
 
-### Remarks [PUT /remarks]
+### Remarks [PUT /remarks/]
 
 This request will change the given remarks, return all remarks for given recordLocator and officeId
 
@@ -510,7 +510,7 @@ This request will change the given remarks, return all remarks for given recordL
 
             <!-- include(remarks/error-response_schema.json) -->
 
-### Remarks [DELETE /remarks]
+### Remarks [DELETE /remarks/]
 
 This request will delete the given remarks, return all remarks for given recordLocator and officeId