Add ExistPhone resource

Author: gmorales96

cuenca/__init__.py

@@ -45,6 +45,7 @@
     'TermsOfService',
     'UserTOSAgreement',
     'PostalCodes',
+    'ExistPhone',
 ]
 
 from . import http
@@ -64,6 +65,7 @@
     CurpValidation,
     Deposit,
     Endpoint,
+    ExistPhone,
     File,
     FileBatch,
     Identity,

cuenca/resources/__init__.py

@@ -16,6 +16,7 @@
     'Endpoint',
     'File',
     'FileBatch',
+    'ExistPhone',
     'Identity',
     'IdentityEvent',
     'KYCValidation',
@@ -58,6 +59,7 @@
 from .curp_validations import CurpValidation
 from .deposits import Deposit
 from .endpoints import Endpoint
+from .exist_phone import ExistPhone
 from .file_batches import FileBatch
 from .files import File
 from .identities import Identity

cuenca/resources/exist_phone.py

@@ -0,0 +1,12 @@
+from typing import ClassVar
+
+from pydantic_extra_types.phone_numbers import PhoneNumber
+
+from .base import Retrievable
+
+
+class ExistPhone(Retrievable):
+    _resource: ClassVar = 'exist_phone'
+
+    id: PhoneNumber
+    exist: bool

cuenca/version.py

@@ -1,3 +1,3 @@
-__version__ = '2.1.6'
+__version__ = '2.1.7'
 CLIENT_VERSION = __version__
 API_VERSION = '2020-03-19'

tests/resources/cassettes/test_exist_phone_retrieve.yaml

@@ -0,0 +1,40 @@
+interactions:
+- request:
+    body: null
+    headers:
+      User-Agent:
+      - cuenca-python/2.1.7.dev1
+      X-Cuenca-Api-Version:
+      - '2020-03-19'
+    method: GET
+    uri: https://sandbox.cuenca.com/exist_phone/+527331256958
+  response:
+    body:
+      string: '{"id":"+527331256958","exist":true}'
+    headers:
+      Connection:
+      - keep-alive
+      Content-Length:
+      - '35'
+      Content-Type:
+      - application/json
+      Date:
+      - Thu, 17 Jul 2025 18:34:19 GMT
+      X-Request-Time:
+      - 'value: 0.041'
+      x-amz-apigw-id:
+      - N3dG4EzACYcEofg=
+      x-amzn-Remapped-Connection:
+      - keep-alive
+      x-amzn-Remapped-Content-Length:
+      - '35'
+      x-amzn-Remapped-Date:
+      - Thu, 17 Jul 2025 18:34:19 GMT
+      x-amzn-Remapped-Server:
+      - nginx/1.28.0
+      x-amzn-RequestId:
+      - 51d8507c-c023-4b91-aa52-a6bdc499df89
+    status:
+      code: 200
+      message: OK
+version: 1

tests/resources/test_exist_phone.py

@@ -0,0 +1,11 @@
+import pytest
+
+from cuenca import ExistPhone
+
+
+@pytest.mark.vcr
+def test_exist_phone_retrieve():
+    phone_number = '+527331256958'
+    exist_phone: ExistPhone = ExistPhone.retrieve(phone_number)
+    assert exist_phone.id == phone_number
+    assert exist_phone.exist