Pull request #11: Added methods to get info from PhoneId

Merge in SDK/php_telesign_enterprise from feature/EOA2091 to developer

Squashed commit of the following:

commit be2e28afbdabebd7c170fe846d3a18630f4bc491
Author: Juan Camilo Martinez <jmartinez@telesign.com>
Date:   Thu Jun 26 14:36:51 2025 -0500

    fix description of RELEASE file

commit 65fd817c9877678e71dbc14180281eb694893eda
Author: Juan Camilo Martinez <jmartinez@telesign.com>
Date:   Wed Jun 25 16:08:20 2025 -0500

    Added methods to get info from PhoneId

Author: jmartinez-telesign

RELEASE

@@ -1,3 +1,6 @@
+3.3.0
+- Added methods to get information about a specified phone number
+
 3.2.0
 - Added method to update verification process.
 - Added method to retrieve verification process.

src/phoneid/PhoneIdClient.php

@@ -20,6 +20,8 @@ class PhoneIdClient extends _PhoneIdClient {
   const PHONEID_CONTACT_RESOURCE = "/v1/phoneid/contact/%s";
   const PHONEID_LIVE_RESOURCE = "/v1/phoneid/live/%s";
   const PHONEID_NUMBER_DEACTIVATION_RESOURCE = "/v1/phoneid/number_deactivation/%s";
+  const PHONEID_GET_INFO_PATH = "/v1/phoneid/%s";
+  const PHONEID_GET_INFO_PATH_ALT = "/v1/phoneid";
 
   function __construct ($customer_id, $api_key, $rest_endpoint = "https://rest-ww.telesign.com", ...$other) {
     $sdk_version_origin = Config::getVersion('telesign/telesignenterprise');
@@ -85,4 +87,35 @@ function numberDeactivation ($phone_number, $ucid, array $other = []) {
     ]));
   }
 
+  /**
+   * Enter a phone number with country code to receive detailed information about carrier, location, and other details.
+   *
+   * See https://developer.telesign.com/enterprise/reference/submitphonenumberforidentity for detailed API documentation.
+   */
+
+  function getInfo ($phone_number, array $params = []) {
+    if (!isset($params["consent"])) {
+      $params["consent"] = [
+        "method" => 1
+      ];
+    }
+    return $this->post(sprintf(self::PHONEID_GET_INFO_PATH, $phone_number), $params, null, null, "application/json", "Basic");
+  }
+
+  /**
+   * Enter a phone number with country code to receive detailed information about carrier, location, and other details.
+   *
+   * See https://developer.telesign.com/enterprise/reference/submitphonenumberforidentityalt for detailed API documentation.
+   */
+
+  function getInfoAlt ($phone_number, array $params = []) {
+    $params["phone_number"] = $phone_number;
+
+    if (!isset($params["consent"])) {
+      $params["consent"] = [
+        "method" => 1
+      ];
+    }
+    return $this->post(self::PHONEID_GET_INFO_PATH_ALT, $params, null, null, "application/json", "Basic");
+  }
 }

test/phoneid/PhoneIdClientTest.php

@@ -84,6 +84,24 @@ function getRequestExamples () {
         ],
         "uri" => self::EXAMPLE_REST_ENDPOINT . "/v1/phoneid/" . self::EXAMPLE_PHONE_NUMBER,
         "{}",
+      ],
+      [
+        PhoneIdClient::class,
+        "getInfo",
+        [
+          self::EXAMPLE_PHONE_NUMBER,
+        ],
+        "uri" => self::EXAMPLE_REST_ENDPOINT . "/v1/phoneid/" . self::EXAMPLE_PHONE_NUMBER,
+        '{"consent":{"method":1}}',
+      ],
+      [
+        PhoneIdClient::class,
+        "getInfoAlt",
+        [
+          self::EXAMPLE_PHONE_NUMBER,
+        ],
+        "uri" => self::EXAMPLE_REST_ENDPOINT . "/v1/phoneid",
+        '{"phone_number":"'.self::EXAMPLE_PHONE_NUMBER.'","consent":{"method":1}}',
       ]
     ];
   }