Metadata-Version: 2.4
Name: bridgexapi
Version: 0.2.0
Summary: Python SMS API SDK for sending SMS, bulk messaging and OTP delivery with route-based control and delivery tracking (Twilio alternative)
Author: BridgeXAPI
Project-URL: Homepage, https://github.com/bridgexapi-dev/bridgexapi-python-sdk
Project-URL: Source, https://github.com/bridgexapi-dev/bridgexapi-python-sdk
Project-URL: Documentation, https://docs.bridgexapi.io
Keywords: sms,sms api,python sms,send sms python,bulk sms,otp sms,twilio alternative,messaging api,sms sdk,sms python api,bridgexapi
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Operating System :: OS Independent
Classifier: Topic :: Communications
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.31.0
Dynamic: license-file

# BridgeXAPI Python SDK

Python SMS API SDK for sending SMS, bulk messaging and OTP delivery.

BridgeXAPI adds route-based control, pricing visibility and delivery tracking.

A developer-first alternative to traditional SMS APIs.

BridgeXAPI exposes SMS delivery as programmable infrastructure.

Most SMS APIs abstract routing behind a single endpoint.

BridgeXAPI does not.

You explicitly choose the route (`route_id`) for every message:
- control delivery paths
- control pricing per destination
- observe delivery using BridgeX message identifiers

This SDK provides a direct interface to that system.

---

## Installation

```bash
pip install bridgexapi
```

---

## Quick Start

```python
from bridgexapi import BridgeXAPI, Route

client = BridgeXAPI(api_key="YOUR_API_KEY")

response = client.send_one(
    route_id=Route.ROUTE_2,
    caller_id="BRIDGEXAPI",
    number="31612345678",
    message="Your verification code is 483921",
)

print(response.to_dict())
```

---

## Core Concept

BridgeXAPI makes routing explicit.

Messaging becomes part of your backend logic, not a black box.
