# MiniMoth

> WhatsApp/SMS OTP authentication API for Indian developers and startups. Send and verify OTPs via two REST endpoints — no WhatsApp Business Account setup, no TRAI DLT registration, no telecom paperwork. MiniMoth handles all regulatory complexity for both channels.

MiniMoth is built for Indian phone numbers (+91). Every OTP is sent over WhatsApp first, falling back to SMS automatically if WhatsApp delivery fails — both channels run on MiniMoth's own infrastructure, so customers never set up a WhatsApp Business Account, register an SMS sender ID, or manage compliance for either. API keys are prefixed `mm_live_` for live and `mm_test_` for test mode (test mode returns fixed OTP `000000`, no message sent, no credits consumed).

Base URL: `https://api.minimoth.dev`

Authentication: Pass your API key in the `X-Api-Key` header on every request.

## Docs

- [Quickstart](https://minimoth.dev/docs/quickstart): Get an API key and send your first OTP in under 5 minutes.
- [Authentication](https://minimoth.dev/docs/authentication): How to use your API key and what the rate limits are.
- [Sessions](https://minimoth.dev/docs/sessions): Validate, refresh, and log out user sessions.
- [Identity](https://minimoth.dev/docs/identity): Recognise the same phone number across logins, and delete an identity on request.
- [Node.js SDK](https://minimoth.dev/docs/sdk-nodejs): Integrate MiniMoth into Node.js, Express, and Next.js apps using the official SDK.
- [Recipes](https://minimoth.dev/docs/recipes): Common integration patterns: OTP-only delivery, protecting routes, and handling token refresh.
- [Error Codes](https://minimoth.dev/docs/error-codes): Complete list of MiniMoth API error codes and their meanings.
- [Branding](https://minimoth.dev/docs/branding): Powered by MiniMoth badges — help your users recognise the OTP sender before the message arrives.
- [Firebase](https://minimoth.dev/docs/integrations/firebase): Verify a phone number with MiniMoth, then mint a Firebase custom token from your own backend.
- [Supabase](https://minimoth.dev/docs/integrations/supabase): Use MiniMoth as Supabase Auth's Send SMS Hook for WhatsApp-first, SMS-fallback OTP delivery to Indian phone numbers.
- [Auth0](https://minimoth.dev/docs/integrations/auth0): Use MiniMoth as Auth0's custom phone provider for WhatsApp-first, SMS-fallback OTP delivery to Indian phone numbers.
- [Test Group](https://minimoth.dev/docs/integrations/test-group): Let up to 5 real testers preview OTPs sent through your Supabase or Auth0 Test Hook, with no real messages sent and no charge for the previews themselves.

Full page content for every doc above: https://minimoth.dev/llms-full.txt