diff --git a/dist/paystack.yaml b/dist/paystack.yaml
index 469c558..168e0ee 100644
--- a/dist/paystack.yaml
+++ b/dist/paystack.yaml
@@ -4721,13 +4721,16 @@ paths:
       tags:
         - Miscellaneous
       summary: Resolve Card BIN
+      description: Get the details of a card BIN
       operationId: miscellaneous_resolveCardBin
       parameters:
         - name: bin
+          description: The card bank identification number
           in: path
           required: true
           schema:
-            type: string
+            type: integer
+          example: 539983
       responses:
         '200':
           $ref: '#/components/responses/VerificationResolveCardBINSuccess'
@@ -4742,6 +4745,7 @@ paths:
       tags:
         - Miscellaneous
       summary: List Countries
+      description: List all supported countries on Paystack
       operationId: miscellaneous_listCountries
       responses:
         '200':
@@ -4765,7 +4769,7 @@ paths:
           description: The country code of the states to list. It is gotten after the charge request
           schema:
             type: string
-            example: CA
+          example: CA
       responses:
         '200':
           $ref: '#/components/responses/MiscellaneousListStatesSuccess'
diff --git a/src/assets/openapi/paths/address_verification_states.yaml b/src/assets/openapi/paths/address_verification_states.yaml
index e386722..215ac28 100644
--- a/src/assets/openapi/paths/address_verification_states.yaml
+++ b/src/assets/openapi/paths/address_verification_states.yaml
@@ -10,7 +10,7 @@ get:
       description: The country code of the states to list. It is gotten after the charge request
       schema:
         type: string
-        example: CA
+      example: CA
   responses:
     '200':
       $ref: ../components/responses/MiscellaneousListStatesSuccess.yaml
diff --git a/src/assets/openapi/paths/country.yaml b/src/assets/openapi/paths/country.yaml
index c7073c8..91a55b2 100644
--- a/src/assets/openapi/paths/country.yaml
+++ b/src/assets/openapi/paths/country.yaml
@@ -2,6 +2,7 @@ get:
   tags:
     - Miscellaneous
   summary: List Countries
+  description: List all supported countries on Paystack
   operationId: miscellaneous_listCountries
   responses:
     '200':
diff --git a/src/assets/openapi/paths/decision_bin_{bin}.yaml b/src/assets/openapi/paths/decision_bin_{bin}.yaml
index 1d4b770..90c2688 100644
--- a/src/assets/openapi/paths/decision_bin_{bin}.yaml
+++ b/src/assets/openapi/paths/decision_bin_{bin}.yaml
@@ -2,13 +2,16 @@ get:
   tags:
     - Miscellaneous
   summary: Resolve Card BIN
+  description: Get the details of a card BIN
   operationId: miscellaneous_resolveCardBin
   parameters:
     - name: bin
+      description: The card bank identification number
       in: path
       required: true
       schema:
-        type: string
+        type: integer
+      example: 539983
   responses:
     '200':
       $ref: ../components/responses/VerificationResolveCardBINSuccess.yaml