# KuruMesaju

> Maldives SMS and OTP gateway HTTP API (v1). Recipients are +960 mobile numbers. Integrators use a Bearer API key; Android phones use a Bearer device token to pull jobs and report results.

For AI agents and code generators: prefer the Markdown or OpenAPI URLs below over scraping HTML.

## API documentation

- [API reference (Markdown)](https://kurumesaju.rashydh.com/docs/api.md): full endpoint reference, request/response JSON, error shapes — best for LLM context
- [OpenAPI 3.1 (JSON)](https://kurumesaju.rashydh.com/docs/openapi.json): machine-readable schema for tools and agents
- [Agent index (JSON)](https://kurumesaju.rashydh.com/docs/api.json): compact discovery document with auth, rate limits, and endpoint list
- [API reference (HTML)](https://kurumesaju.rashydh.com/docs): human-readable docs

## Base URL

https://kurumesaju.rashydh.com/api/v1

## Quick start

1. Obtain an API key from the service operator.
2. `POST https://kurumesaju.rashydh.com/api/v1/sms` with `Authorization: Bearer API_KEY` and JSON `{"to":"+9607711097","body":"…"}`.
3. Configure a device with webhook or poll `GET https://kurumesaju.rashydh.com/api/v1/device/jobs/next` using the device token.
4. After the phone sends the SMS, `POST https://kurumesaju.rashydh.com/api/v1/device/jobs/{id}/result` with `{"status":"sent"}`.