# OxgelAPI

> OxgelAPI is a developer platform for virtual phone numbers, OTP/SMS verification, bulk SMS and SMM (social media marketing) APIs. One REST API, 200+ countries, 1000+ services (WhatsApp, Telegram, Google, Facebook, OpenAI, Discord, etc.). Pay-as-you-go in USD, refundable wallet balance, no subscription.

Base URL: `https://oxgelapi.com/api/v1`
Auth: HTTP header `X-API-Key: OXGL-xxxxxxxxxxxx` (get one at https://oxgelapi.com/dashboard/api-keys after signing up)

## Docs

- [Public API documentation page](https://oxgelapi.com/docs.html): No-login HTML docs with endpoint tables and examples for humans and AI agents.
- [Full API reference (Markdown)](https://oxgelapi.com/api-docs.md): Every endpoint, every parameter, request/response examples in Node, Python, cURL.
- [Alternate Markdown URL](https://oxgelapi.com/docs.md): Same public reference at a simple docs.md path.
- [OpenAPI 3.1 spec (JSON)](https://oxgelapi.com/openapi.json): Machine-readable schema for code generators and AI agents.
- [llms-full.txt](https://oxgelapi.com/llms-full.txt): Same content as api-docs.md, optimized for LLM context windows.

## Quick start

```bash
curl -H "X-API-Key: OXGL-YOUR-KEY" https://oxgelapi.com/api/v1/balance
```

## Endpoints

- `GET  /balance` — Wallet balance in USD
- `GET  /services` — List supported services (whatsapp, telegram, google, …)
- `GET  /countries` — List supported countries (ISO codes)
- `GET  /prices?service=wa&country=us` — Current price + stock per country
- `POST /numbers/buy` — Rent a number (body: `{service, country, operator?}`)
- `GET  /numbers/status?id=ORDER_ID` — Poll for incoming SMS code
- `POST /numbers/cancel?id=ORDER_ID` — Cancel & refund (allowed after 2 min)
- `POST /numbers/finish?id=ORDER_ID` — Mark order complete
- `POST /numbers/another?id=ORDER_ID` — Request another SMS for the same number