# SplitSMS

> Bulk SMS, OTP, and wallet API for Ghana, Nigeria, and 190+ countries. Operated by Tecunit.

## Docs for AI / vibe coding

- OpenAPI: http://localhost:3000/openapi.json
- API reference: http://localhost:3000/api-docs
- Developer portal: http://localhost:3000/developers
- Integration generator: http://localhost:3000/developers/generate
- AI prompt library: http://localhost:3000/developers/prompts
- Vibe coders landing: http://localhost:3000/vibe-coders
- SMS solutions hub: http://localhost:3000/solutions
- SMS Ghana: http://localhost:3000/solutions/sms
- mNotify alternative: http://localhost:3000/solutions/mnotify
- Infobip alternative: http://localhost:3000/solutions/infobip
- OTP SMS API: http://localhost:3000/solutions/otp
- WooCommerce SMS: http://localhost:3000/solutions/woocommerce-sms
- Paystack SMS: http://localhost:3000/solutions/paystack-sms
- SMS integration: http://localhost:3000/solutions/sms-integration
- SDK install: http://localhost:3000/sdk
- Postman: http://localhost:3000/developers/postman

## Authentication

All API requests: `Authorization: Bearer YOUR_API_KEY`
Base URL: http://localhost:3000/api/v1

Create keys at http://localhost:3000/developers/api-keys
Use sandbox keys (sk_test_) for safe development — no live SMS, no credit charges.
OTP sandbox verify code: 123456

## Core endpoints

| Method | Path | Purpose |
|--------|------|---------|
| GET | /balance | Wallet + SMS credits |
| POST | /sms/send | Send SMS |
| POST | /otp/send | Send OTP |
| POST | /otp/verify | Verify OTP |
| GET | /reports | Delivery reports |
| POST | /connect/customers | Provision embedded customer |
| GET | /sender-ids | List sender IDs |

Full spec: http://localhost:3000/openapi.json

## JavaScript SDK

Install (NOT from npm registry):
```bash
npm install http://localhost:3000/sdk/javascript/splitsms-sdk.tgz
```

```ts
import { SplitSMS } from "@splitsms/sdk";
const client = new SplitSMS({ apiKey: process.env.SPLITSMS_API_KEY!, baseUrl: "http://localhost:3000" });
await client.messages.send({ sender: "MYBRAND", recipients: ["233201234567"], message: "Hello" });
```

## WordPress

Official plugin v1.7.2: http://localhost:3000/integrations/wordpress
Download: http://localhost:3000/wordpress-plugin/splitsms.zip
WooCommerce, WPForms, CF7, Elementor, JetFormBuilder, Crocoblock supported.

## Environment variables

SPLITSMS_API_KEY=sk_test_... or sk_live_...
SPLITSMS_BASE_URL=http://localhost:3000

## Support

http://localhost:3000/support