diff --git a/api/v1/swagger/definitions/vendors_config.yaml b/api/v1/swagger/definitions/vendors_config.yaml
index 7c52ced670..7e7819a95e 100644
--- a/api/v1/swagger/definitions/vendors_config.yaml
+++ b/api/v1/swagger/definitions/vendors_config.yaml
@@ -9,11 +9,11 @@ properties:
     description: List of currencies
   gst_values:
     type: array
-    description: List of GST values
+    description: List of tax rates
   edifact:
     type: boolean
-    description: EDIFACT syspref value
+    description: EDIFACT system preference value
   marc_orders:
     type: boolean
-    description: MarcOrderingAutomation syspref value
+    description: MarcOrderingAutomation system preference value
 additionalProperties: false