namecheap-python 1.1.0__tar.gz → 1.3.0__tar.gz

namecheap_python-1.3.0/CLAUDE.md

@@ -0,0 +1,2 @@
+@README.md
+@CONTRIBUTING.md

namecheap_python-1.3.0/CONTRIBUTING.md

@@ -0,0 +1,113 @@
+# Contributing
+
+## Setup
+
+```bash
+git clone https://github.com/adriangalilea/namecheap-python.git
+cd namecheap-python
+uv sync --all-extras
+pre-commit install
+```
+
+## Code Quality
+
+```bash
+uv run ruff check        # lint
+uv run ruff check --fix  # auto-fix
+uv run ruff format       # format
+
+pre-commit run --all-files  # run all hooks
+```
+
+## Building
+
+```bash
+uv build
+```
+
+## Release
+
+Automated via GitHub Actions on push to `main`. If the version in `pyproject.toml` doesn't exist on PyPI, CI publishes automatically, creates a git tag, and generates a GitHub release with changelog via [git-cliff](https://git-cliff.org/).
+
+Bump version in both `pyproject.toml` and `src/namecheap/__init__.py`.
+
+## Debugging
+
+```python
+import logging
+logging.basicConfig(level=logging.DEBUG)
+```
+
+Or set `NAMECHEAP_DEBUG=true`.
+
+## Architecture
+
+### Project Structure
+
+```
+src/
+├── namecheap/              # Core SDK
+│   ├── client.py           # Main client — wires up API classes
+│   ├── models.py           # Pydantic models (all API data types live here)
+│   ├── errors.py           # Exceptions with helpful messages
+│   ├── logging.py          # Colored logging and error display
+│   └── _api/               # API implementations
+│       ├── base.py         # BaseAPI with _request() — all API calls go through here
+│       ├── domains.py      # namecheap.domains.* endpoints
+│       └── dns.py          # namecheap.domains.dns.* endpoints + builder
+├── namecheap_cli/          # CLI (click)
+│   ├── __main__.py         # All commands in one file
+│   └── completion.py       # Shell completions
+└── namecheap_dns_tui/      # TUI (textual)
+    └── __main__.py
+```
+
+### Key Patterns
+
+**SDK layer** (`src/namecheap/_api/`):
+- Every API class extends `BaseAPI` which provides `_request(command, params, model=, path=)`
+- `_request` handles auth params, XML parsing, error handling, and Pydantic deserialization
+- Pass `model=SomeModel` to auto-parse, or omit for raw dict access
+- Pass `path="DotSeparated.Path"` to navigate the XML response
+- Domain parsing uses `tldextract` to split into SLD/TLD — see any method in `dns.py`
+- Return Pydantic models, not dicts — see `Nameservers`, `DNSRecord`, `Domain`, etc.
+- Use `assert` for assumptions, `ValueError` for bad user input
+
+**Models** (`src/namecheap/models.py`):
+- `XMLModel` base handles XML attribute aliases (`@Name` → `name`) and boolean parsing
+- All new data types go here and get exported from `__init__.py`
+
+**CLI layer** (`src/namecheap_cli/__main__.py`):
+- Commands use `@pass_config` decorator for client initialization
+- Interactive operations use `rich.progress.Progress` with `SpinnerColumn` for loading
+- Destructive operations use `rich.prompt.Confirm.ask` with `--yes/-y` to skip
+- Table output via `rich.table.Table`, with `output_formatter()` for JSON/YAML alternatives
+- Error handling: catch `NamecheapError`, print with `[red]`, `sys.exit(1)`
+
+**DNS Builder** (`src/namecheap/_api/dns.py`):
+- Fluent interface: `builder.a(...).mx(...).txt(...)` returns `Self` for chaining
+- Default TTL is 1799 (displays as "Automatic" in Namecheap UI)
+
+### Adding a New API Endpoint
+
+1. Add Pydantic model in `models.py`, export from `__init__.py`
+2. Add method in the appropriate `_api/*.py` file using `self._request()`
+3. Add CLI command in `__main__.py` following existing patterns
+4. Update the API Coverage table in `README.md`
+
+Best reference: `dns.py:get_nameservers()` for SDK, `__main__.py:dns_nameservers()` for CLI.
+
+## PR Checklist
+
+- [ ] `uv run ruff check` passes
+- [ ] `uv run ruff format --check` passes
+- [ ] Examples work correctly
+- [ ] Documentation updated if needed
+
+## Links
+
+- [Namecheap API Documentation](https://www.namecheap.com/support/api/methods/)
+- [Pydantic Documentation](https://docs.pydantic.dev/)
+- [Click Documentation](https://click.palletsprojects.com/)
+- [Textual Documentation](https://textual.textualize.io/)
+- [Ruff Documentation](https://docs.astral.sh/ruff/)

{namecheap_python-1.1.0 → namecheap_python-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: namecheap-python
-Version: 1.1.0
+Version: 1.3.0
 Summary: A friendly Python SDK for Namecheap API
 Project-URL: Homepage, https://github.com/adriangalilea/namecheap-python
 Project-URL: Repository, https://github.com/adriangalilea/namecheap-python
@@ -42,6 +42,12 @@ Description-Content-Type: text/markdown
 
 # Namecheap Python SDK
 
+[![PyPI version](https://badge.fury.io/py/namecheap-python.svg)](https://pypi.org/project/namecheap-python/)
+[![Downloads](https://pepy.tech/badge/namecheap-python)](https://pepy.tech/project/namecheap-python)
+[![Downloads/month](https://pepy.tech/badge/namecheap-python/month)](https://pepy.tech/project/namecheap-python)
+[![Python](https://img.shields.io/pypi/pyversions/namecheap-python)](https://pypi.org/project/namecheap-python/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 A modern, friendly Python SDK for the Namecheap API with comprehensive CLI and TUI tools.
 
 ## 🚀 Features
@@ -206,6 +212,38 @@ Adding CNAME record to tdo.garden...
 ```
 
 
+Check account balance:
+
+```bash
+❯ namecheap-cli account balance
+          Account Balance
+┏━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━┓
+┃ Field               ┃    Amount ┃
+┡━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━┩
+│ Available Balance   │  0.00 USD │
+│ Account Balance     │  0.00 USD │
+│ Earned Amount       │  0.00 USD │
+│ Withdrawable        │  0.00 USD │
+│ Auto-Renew Required │ 20.16 USD │
+└─────────────────────┴───────────┘
+```
+
+Get detailed domain info:
+
+```bash
+❯ namecheap-cli domain info self.fm
+
+Domain Information: self.fm
+
+Status: Ok
+Owner: adriangalilea
+Created: 07/15/2023
+Expires: 07/15/2026
+Premium: No
+WHOIS Guard: ✓ Enabled
+DNS Provider: CUSTOM
+```
+
 You can also export DNS records:
 
 ```bash
@@ -320,6 +358,48 @@ nc.dns.set_custom_nameservers("example.com", [
 nc.dns.set_default_nameservers("example.com")
 ```
 
+### Domain Info
+
+```python
+info = nc.domains.get_info("example.com")
+print(info.status)              # 'Ok'
+print(info.whoisguard_enabled)  # True
+print(info.dns_provider)        # 'CUSTOM'
+print(info.created)             # '07/15/2023'
+print(info.expires)             # '07/15/2026'
+```
+
+### Account Balance
+
+```python
+bal = nc.users.get_balances()
+print(f"{bal.available_balance} {bal.currency}")  # '4932.96 USD'
+print(bal.funds_required_for_auto_renew)          # Decimal('20.16')
+```
+
+### Email Forwarding
+
+```python
+# Read
+rules = nc.dns.get_email_forwarding("example.com")
+for r in rules:
+    print(f"{r.mailbox} -> {r.forward_to}")
+
+# Write (replaces all existing rules)
+nc.dns.set_email_forwarding("example.com", [
+    EmailForward(mailbox="info", forward_to="me@gmail.com"),
+    EmailForward(mailbox="support", forward_to="help@gmail.com"),
+])
+```
+
+### Domain Contacts
+
+```python
+contacts = nc.domains.get_contacts("example.com")
+print(f"{contacts.registrant.first_name} {contacts.registrant.last_name}")
+print(contacts.registrant.email)
+```
+
 ### Domain Management
 
 ```python
@@ -393,22 +473,23 @@ nc.dns.builder().a("www", "192.0.2.1", ttl=1799)  # Shows as "Automatic"
 nc.dns.builder().a("www", "192.0.2.1", ttl=1800)  # Shows as "30 min"
 ```
 
-## 🚧 Pending Features
-
-The following Namecheap API features are planned for future releases:
-
-- **SSL API** - Certificate management
-- **Domain Transfer API** - Transfer domains between registrars
-- **Domain NS API** - Glue record management (child nameservers)
-- **Users API** - Account management and balance checking
-- **Whois API** - WHOIS information lookups
-- **Email Forwarding** - Email forwarding configuration
+## 📊 [API Coverage](https://www.namecheap.com/support/api/methods/)
 
-See [pending.md](pending.md) for full details.
+| API | Status | Methods |
+|-----|--------|---------|
+| `namecheap.domains.*` | ✅ Done | `check`, `list`, `getInfo`, `getContacts`, `register`, `renew`, `setContacts`, `lock`/`unlock` |
+| `namecheap.domains.dns.*` | ✅ Done | `getHosts`, `setHosts` (builder pattern), `add`, `delete`, `export`, `getList`, `setCustom`, `setDefault`, `getEmailForwarding`, `setEmailForwarding` |
+| `namecheap.users.*` | ⚠️ Partial | `getBalances`, `getPricing` (needs debugging). Planned: `changePassword`, `update`, `create`, `login`, `resetPassword` |
+| `namecheap.domains.*` | 🚧 Planned | `getTldList`, `reactivate` |
+| `namecheap.users.address.*` | 🚧 Planned | `create`, `delete`, `getInfo`, `getList`, `setDefault`, `update` |
+| `namecheap.ssl.*` | 🚧 Planned | `create`, `activate`, `renew`, `revoke`, `getList`, `getInfo`, `parseCSR`, `reissue`, and more |
+| `namecheap.domains.transfer.*` | 🚧 Planned | `create`, `getStatus`, `updateStatus`, `getList` |
+| `namecheap.domains.ns.*` | 🚧 Planned | Glue records — `create`, `delete`, `getInfo`, `update` |
+| `namecheap.domainprivacy.*` | 🚧 Planned | `enable`, `disable`, `renew`, `getList`, `changeemailaddress` |
 
 ## 🛠️ Development
 
-See [Development Guide](docs/dev/README.md) for detailed development instructions.
+See [CONTRIBUTING.md](CONTRIBUTING.md) for setup and development guidelines.
 
 ## 📝 License
 
@@ -420,4 +501,6 @@ Contributions are welcome! Please feel free to submit a Pull Request. See the [D
 
 ### Contributors
 
+- [@huntertur](https://github.com/huntertur) — Rich dependency fix
+- [@jeffmcadams](https://github.com/jeffmcadams) — Domain serialization round-trip
 - [@cosmin](https://github.com/cosmin) — Nameserver management

{namecheap_python-1.1.0 → namecheap_python-1.3.0}/README.md

@@ -1,5 +1,11 @@
 # Namecheap Python SDK
 
+[![PyPI version](https://badge.fury.io/py/namecheap-python.svg)](https://pypi.org/project/namecheap-python/)
+[![Downloads](https://pepy.tech/badge/namecheap-python)](https://pepy.tech/project/namecheap-python)
+[![Downloads/month](https://pepy.tech/badge/namecheap-python/month)](https://pepy.tech/project/namecheap-python)
+[![Python](https://img.shields.io/pypi/pyversions/namecheap-python)](https://pypi.org/project/namecheap-python/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 A modern, friendly Python SDK for the Namecheap API with comprehensive CLI and TUI tools.
 
 ## 🚀 Features
@@ -164,6 +170,38 @@ Adding CNAME record to tdo.garden...
 ```
 
 
+Check account balance:
+
+```bash
+❯ namecheap-cli account balance
+          Account Balance
+┏━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━┓
+┃ Field               ┃    Amount ┃
+┡━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━┩
+│ Available Balance   │  0.00 USD │
+│ Account Balance     │  0.00 USD │
+│ Earned Amount       │  0.00 USD │
+│ Withdrawable        │  0.00 USD │
+│ Auto-Renew Required │ 20.16 USD │
+└─────────────────────┴───────────┘
+```
+
+Get detailed domain info:
+
+```bash
+❯ namecheap-cli domain info self.fm
+
+Domain Information: self.fm
+
+Status: Ok
+Owner: adriangalilea
+Created: 07/15/2023
+Expires: 07/15/2026
+Premium: No
+WHOIS Guard: ✓ Enabled
+DNS Provider: CUSTOM
+```
+
 You can also export DNS records:
 
 ```bash
@@ -278,6 +316,48 @@ nc.dns.set_custom_nameservers("example.com", [
 nc.dns.set_default_nameservers("example.com")
 ```
 
+### Domain Info
+
+```python
+info = nc.domains.get_info("example.com")
+print(info.status)              # 'Ok'
+print(info.whoisguard_enabled)  # True
+print(info.dns_provider)        # 'CUSTOM'
+print(info.created)             # '07/15/2023'
+print(info.expires)             # '07/15/2026'
+```
+
+### Account Balance
+
+```python
+bal = nc.users.get_balances()
+print(f"{bal.available_balance} {bal.currency}")  # '4932.96 USD'
+print(bal.funds_required_for_auto_renew)          # Decimal('20.16')
+```
+
+### Email Forwarding
+
+```python
+# Read
+rules = nc.dns.get_email_forwarding("example.com")
+for r in rules:
+    print(f"{r.mailbox} -> {r.forward_to}")
+
+# Write (replaces all existing rules)
+nc.dns.set_email_forwarding("example.com", [
+    EmailForward(mailbox="info", forward_to="me@gmail.com"),
+    EmailForward(mailbox="support", forward_to="help@gmail.com"),
+])
+```
+
+### Domain Contacts
+
+```python
+contacts = nc.domains.get_contacts("example.com")
+print(f"{contacts.registrant.first_name} {contacts.registrant.last_name}")
+print(contacts.registrant.email)
+```
+
 ### Domain Management
 
 ```python
@@ -351,22 +431,23 @@ nc.dns.builder().a("www", "192.0.2.1", ttl=1799)  # Shows as "Automatic"
 nc.dns.builder().a("www", "192.0.2.1", ttl=1800)  # Shows as "30 min"
 ```
 
-## 🚧 Pending Features
-
-The following Namecheap API features are planned for future releases:
-
-- **SSL API** - Certificate management
-- **Domain Transfer API** - Transfer domains between registrars
-- **Domain NS API** - Glue record management (child nameservers)
-- **Users API** - Account management and balance checking
-- **Whois API** - WHOIS information lookups
-- **Email Forwarding** - Email forwarding configuration
+## 📊 [API Coverage](https://www.namecheap.com/support/api/methods/)
 
-See [pending.md](pending.md) for full details.
+| API | Status | Methods |
+|-----|--------|---------|
+| `namecheap.domains.*` | ✅ Done | `check`, `list`, `getInfo`, `getContacts`, `register`, `renew`, `setContacts`, `lock`/`unlock` |
+| `namecheap.domains.dns.*` | ✅ Done | `getHosts`, `setHosts` (builder pattern), `add`, `delete`, `export`, `getList`, `setCustom`, `setDefault`, `getEmailForwarding`, `setEmailForwarding` |
+| `namecheap.users.*` | ⚠️ Partial | `getBalances`, `getPricing` (needs debugging). Planned: `changePassword`, `update`, `create`, `login`, `resetPassword` |
+| `namecheap.domains.*` | 🚧 Planned | `getTldList`, `reactivate` |
+| `namecheap.users.address.*` | 🚧 Planned | `create`, `delete`, `getInfo`, `getList`, `setDefault`, `update` |
+| `namecheap.ssl.*` | 🚧 Planned | `create`, `activate`, `renew`, `revoke`, `getList`, `getInfo`, `parseCSR`, `reissue`, and more |
+| `namecheap.domains.transfer.*` | 🚧 Planned | `create`, `getStatus`, `updateStatus`, `getList` |
+| `namecheap.domains.ns.*` | 🚧 Planned | Glue records — `create`, `delete`, `getInfo`, `update` |
+| `namecheap.domainprivacy.*` | 🚧 Planned | `enable`, `disable`, `renew`, `getList`, `changeemailaddress` |
 
 ## 🛠️ Development
 
-See [Development Guide](docs/dev/README.md) for detailed development instructions.
+See [CONTRIBUTING.md](CONTRIBUTING.md) for setup and development guidelines.
 
 ## 📝 License
 
@@ -378,4 +459,6 @@ Contributions are welcome! Please feel free to submit a Pull Request. See the [D
 
 ### Contributors
 
+- [@huntertur](https://github.com/huntertur) — Rich dependency fix
+- [@jeffmcadams](https://github.com/jeffmcadams) — Domain serialization round-trip
 - [@cosmin](https://github.com/cosmin) — Nameserver management

{namecheap_python-1.1.0 → namecheap_python-1.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "namecheap-python"
-version = "1.1.0"
+version = "1.3.0"
 description = "A friendly Python SDK for Namecheap API"
 authors = [{name = "Adrian Galilea Delgado", email = "adriangalilea@gmail.com"}]
 readme = "README.md"

{namecheap_python-1.1.0 → namecheap_python-1.3.0}/src/namecheap/__init__.py

@@ -12,15 +12,29 @@ from __future__ import annotations
 
 from .client import Namecheap
 from .errors import ConfigurationError, NamecheapError, ValidationError
-from .models import Contact, DNSRecord, Domain, DomainCheck, Nameservers
+from .models import (
+    AccountBalance,
+    Contact,
+    DNSRecord,
+    Domain,
+    DomainCheck,
+    DomainContacts,
+    DomainInfo,
+    EmailForward,
+    Nameservers,
+)
 
-__version__ = "1.1.0"
+__version__ = "1.3.0"
 __all__ = [
+    "AccountBalance",
     "ConfigurationError",
     "Contact",
     "DNSRecord",
     "Domain",
     "DomainCheck",
+    "DomainContacts",
+    "DomainInfo",
+    "EmailForward",
     "Namecheap",
     "NamecheapError",
     "Nameservers",

{namecheap_python-1.1.0 → namecheap_python-1.3.0}/src/namecheap/_api/dns.py

@@ -6,7 +6,7 @@ from typing import TYPE_CHECKING, Any, Literal
 
 import tldextract
 
-from namecheap.models import DNSRecord, Nameservers
+from namecheap.models import DNSRecord, EmailForward, Nameservers
 
 from .base import BaseAPI
 
@@ -494,3 +494,75 @@ class DnsAPI(BaseAPI):
         nameservers = [ns_data] if isinstance(ns_data, str) else ns_data
 
         return Nameservers(is_default=is_default, nameservers=nameservers)
+
+    def get_email_forwarding(self, domain: str) -> list[EmailForward]:
+        """
+        Get email forwarding rules for a domain.
+
+        Args:
+            domain: Domain name
+
+        Returns:
+            List of EmailForward rules
+
+        Examples:
+            >>> rules = nc.dns.get_email_forwarding("example.com")
+            >>> for r in rules:
+            ...     print(f"{r.mailbox} -> {r.forward_to}")
+        """
+        result: Any = self._request(
+            "namecheap.domains.dns.getEmailForwarding",
+            {"DomainName": domain},
+            path="DomainDNSGetEmailForwardingResult",
+        )
+
+        if not result:
+            return []
+
+        forwards = result.get("Forward", [])
+        if isinstance(forwards, dict):
+            forwards = [forwards]
+        assert isinstance(forwards, list), f"Unexpected Forward type: {type(forwards)}"
+
+        return [
+            EmailForward(mailbox=f.get("@mailbox", ""), forward_to=f.get("#text", ""))
+            for f in forwards
+        ]
+
+    def set_email_forwarding(
+        self, domain: str, rules: list[EmailForward] | list[dict[str, str]]
+    ) -> bool:
+        """
+        Set email forwarding rules for a domain. Replaces all existing rules.
+
+        Args:
+            domain: Domain name
+            rules: List of EmailForward or dicts with 'mailbox' and 'forward_to' keys
+
+        Returns:
+            True if successful
+
+        Examples:
+            >>> nc.dns.set_email_forwarding("example.com", [
+            ...     EmailForward(mailbox="info", forward_to="me@gmail.com"),
+            ...     EmailForward(mailbox="support", forward_to="help@gmail.com"),
+            ... ])
+        """
+        assert rules, "At least one forwarding rule is required"
+
+        params: dict[str, Any] = {"DomainName": domain}
+        for i, rule in enumerate(rules, 1):
+            if isinstance(rule, EmailForward):
+                params[f"MailBox{i}"] = rule.mailbox
+                params[f"ForwardTo{i}"] = rule.forward_to
+            else:
+                params[f"MailBox{i}"] = rule["mailbox"]
+                params[f"ForwardTo{i}"] = rule["forward_to"]
+
+        result: Any = self._request(
+            "namecheap.domains.dns.setEmailForwarding",
+            params,
+            path="DomainDNSSetEmailForwardingResult",
+        )
+
+        return bool(result and result.get("@IsSuccess", "false").lower() == "true")

{namecheap_python-1.1.0 → namecheap_python-1.3.0}/src/namecheap/_api/domains.py

@@ -9,7 +9,7 @@ from typing import Any
 import tldextract
 
 from namecheap.logging import logger
-from namecheap.models import Contact, Domain, DomainCheck
+from namecheap.models import Contact, Domain, DomainCheck, DomainContacts, DomainInfo
 
 from .base import BaseAPI
 
@@ -110,6 +110,98 @@ class DomainsAPI(BaseAPI):
             return [results]
         return results if isinstance(results, list) else []
 
+    def get_info(self, domain: str) -> DomainInfo:
+        """
+        Get detailed information about a domain.
+
+        Args:
+            domain: Domain name
+
+        Returns:
+            DomainInfo with status, whoisguard, DNS provider, etc.
+
+        Examples:
+            >>> info = nc.domains.get_info("example.com")
+            >>> print(f"{info.domain} status={info.status} whoisguard={info.whoisguard_enabled}")
+        """
+        result: Any = self._request(
+            "namecheap.domains.getInfo",
+            {"DomainName": domain},
+            path="DomainGetInfoResult",
+        )
+
+        assert result, f"API returned empty result for {domain} getInfo"
+
+        # Extract nested fields into flat structure
+        domain_details = result.get("DomainDetails", {})
+        whoisguard = result.get("Whoisguard", {})
+        dns_details = result.get("DnsDetails", {})
+
+        flat = {
+            "@ID": result.get("@ID"),
+            "@DomainName": result.get("@DomainName"),
+            "@OwnerName": result.get("@OwnerName"),
+            "@IsOwner": result.get("@IsOwner"),
+            "@IsPremium": result.get("@IsPremium", "false"),
+            "@Status": result.get("@Status"),
+            "created": domain_details.get("CreatedDate"),
+            "expires": domain_details.get("ExpiredDate"),
+            "whoisguard_enabled": whoisguard.get("@Enabled", "false").lower() == "true"
+            if isinstance(whoisguard, dict)
+            else False,
+            "dns_provider": dns_details.get("@ProviderType")
+            if isinstance(dns_details, dict)
+            else None,
+        }
+
+        return DomainInfo.model_validate(flat)
+
+    def get_contacts(self, domain: str) -> DomainContacts:
+        """
+        Get contact information for a domain.
+
+        Args:
+            domain: Domain name
+
+        Returns:
+            DomainContacts with registrant, tech, admin, and aux_billing contacts
+
+        Examples:
+            >>> contacts = nc.domains.get_contacts("example.com")
+            >>> print(contacts.registrant.email)
+        """
+        result: Any = self._request(
+            "namecheap.domains.getContacts",
+            {"DomainName": domain},
+            path="DomainContactsResult",
+        )
+
+        assert result, f"API returned empty result for {domain} getContacts"
+
+        def parse_contact(data: dict[str, Any]) -> Contact:
+            return Contact.model_validate(
+                {
+                    "FirstName": data.get("FirstName", ""),
+                    "LastName": data.get("LastName", ""),
+                    "Organization": data.get("Organization"),
+                    "Address1": data.get("Address1", ""),
+                    "Address2": data.get("Address2"),
+                    "City": data.get("City", ""),
+                    "StateProvince": data.get("StateProvince", ""),
+                    "PostalCode": data.get("PostalCode", ""),
+                    "Country": data.get("Country", ""),
+                    "Phone": data.get("Phone", ""),
+                    "EmailAddress": data.get("EmailAddress", ""),
+                }
+            )
+
+        return DomainContacts(
+            registrant=parse_contact(result.get("Registrant", {})),
+            tech=parse_contact(result.get("Tech", {})),
+            admin=parse_contact(result.get("Admin", {})),
+            aux_billing=parse_contact(result.get("AuxBilling", {})),
+        )
+
     def register(
         self,
         domain: str,

namecheap_python-1.3.0/src/namecheap/_api/users.py

@@ -0,0 +1,32 @@
+"""Users API."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from namecheap.models import AccountBalance
+
+from .base import BaseAPI
+
+
+class UsersAPI(BaseAPI):
+    """User account operations."""
+
+    def get_balances(self) -> AccountBalance:
+        """
+        Get account balance information.
+
+        Returns:
+            AccountBalance with available balance, earned amount, etc.
+
+        Examples:
+            >>> bal = nc.users.get_balances()
+            >>> print(f"{bal.available_balance} {bal.currency}")
+        """
+        result: Any = self._request(
+            "namecheap.users.getBalances",
+            path="UserGetBalancesResult",
+        )
+
+        assert result, "API returned empty result for getBalances"
+        return AccountBalance.model_validate(result)