AWS Security ChangesHomeSearch

AWS pinpoint: Add NumberPreference parameter to RequestPhoneNumber

Service: pinpoint · 2026-09-27 · Documentation low

File: pinpoint/latest/apireference_smsvoicev2/API_RequestPhoneNumber.md

Summary

Adds the optional NumberPreference request parameter (array of NumberPreferenceItem with Filter and PreferenceType) allowing selection of a phone number matching a digit pattern; limited to TEN_DLC requests in the US.

Security assessment

Documents a new phone-number selection input; it is a functional capability and does not describe credentials, permissions, encryption, or a fixed vulnerability.

Evidence

+An optional selection preference used to request a specific phone number, such as a number that starts with, ends with, or contains a particular digit pattern. You can specify at most one preference. Number preferences apply only to `TEN_DLC` requests in the `US`.

Diff

diff --git a/pinpoint/latest/apireference_smsvoicev2/API_RequestPhoneNumber.md b/pinpoint/latest/apireference_smsvoicev2/API_RequestPhoneNumber.md
index 47893237a..b957661e2 100644
--- a//pinpoint/latest/apireference_smsvoicev2/API_RequestPhoneNumber.md
+++ b//pinpoint/latest/apireference_smsvoicev2/API_RequestPhoneNumber.md
@@ -22,0 +23,6 @@ Request an origination phone number for use in your account. For more informatio
+       "NumberPreference": [ 
+          { 
+             "[Filter](./API_NumberPreferenceItem.html#pinpoint-Type-NumberPreferenceItem-Filter)": [ "string" ],
+             "[PreferenceType](./API_NumberPreferenceItem.html#pinpoint-Type-NumberPreferenceItem-PreferenceType)": [ "string" ]
+          }
+       ],
@@ -108,0 +115,11 @@ Required: Yes
+**NumberPreference **
+    
+
+An optional selection preference used to request a specific phone number, such as a number that starts with, ends with, or contains a particular digit pattern. You can specify at most one preference. Number preferences apply only to `TEN_DLC` requests in the `US`.
+
+Type: Array of [NumberPreferenceItem](./API_NumberPreferenceItem.html) objects
+
+Array Members: Fixed number of 1 item.
+
+Required: No
+
@@ -512 +529 @@ For more information about using this API in one of the language-specific AWS SD
-  * [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/pinpoint-sms-voice-v2-2022-03-31/RequestPhoneNumber)
+  * [AWS SDK for Python (Boto3)](https://docs.aws.amazon.com/goto/boto3/pinpoint-sms-voice-v2-2022-03-31/RequestPhoneNumber)