diff --git a/site/specs/numbers.yml b/site/specs/numbers.yml
index d0f4857d7..d779ba759 100644
--- a/site/specs/numbers.yml
+++ b/site/specs/numbers.yml
@@ -754,6 +754,7 @@ components:
         type: string
     shortCodeCountryPathParam:
       description: The short code number country.
+      example: USA
       in: path
       name: country
       required: true
@@ -32664,7 +32665,7 @@ paths:
           $ref: '#/components/responses/shortCode429'
         '500':
           $ref: '#/components/responses/shortCode500'
-      summary: Retrieve short code numbers for that account identifier.
+      summary: Retrieve short codes by account.
       tags:
         - Short Codes
   /accounts/{accountId}/shortcodes/{shortCode}/{country}:
@@ -32695,9 +32696,7 @@ paths:
           $ref: '#/components/responses/shortCode429'
         '500':
           $ref: '#/components/responses/shortCode500'
-      summary: >-
-        Retrieve short code details for that account identifier, short code
-        number, and country.
+      summary: Retrieve short code details.
       tags:
         - Short Codes
   /accounts/{accountId}/shortcodes/{shortCode}/{country}/history:
@@ -32732,7 +32731,7 @@ paths:
           $ref: '#/components/responses/shortCode429'
         '500':
           $ref: '#/components/responses/shortCode500'
-      summary: Retrieve short code history for an account, short code, and country.
+      summary: Retrieve short code history.
       tags:
         - Short Codes
   /accounts/{accountId}/sipcredentials: