diff --git a/api/v1/swagger/definitions/suggestion.yaml b/api/v1/swagger/definitions/suggestion.yaml
index 2056188772..bea2ab236d 100644
--- a/api/v1/swagger/definitions/suggestion.yaml
+++ b/api/v1/swagger/definitions/suggestion.yaml
@@ -64,7 +64,16 @@ properties:
     description: date the suggestion was last modified
   status:
     type: string
-    description: Suggestion status
+    description: |
+      Suggestion status. Possible values are:
+
+      * `ASKED`
+      * `CHECKED`
+      * `ACCEPTED`
+      * `REJECTED`
+      * `ORDERED`
+      * `AVAILABLE`
+      * Values from the `SUGGEST_STATUS` av cateogry
   note:
     type:
       - string