OTP API

Send a code to a phone. SEED delivers via WhatsApp (SMS fallback). You verify with challenge_id.

POST /v1/otp/send · POST /v1/otp/verify · GET /v1/otp/{id}

Scopes: otp:send · otp:verify (sms:send also works)

Request

`to`	required	E.164 phone
`code`	optional	4-8 digits; omit to auto-generate
`reference`	optional	your correlation id
`delivery_mode`	optional	auto (default) \| whatsapp \| sms

Advanced: template_name / template_language only if you override the account auth template. Not needed for standard use.

Response

`challenge_id`	for verify + poll
`channel`	whatsapp \| sms
`fallback_used`	true if SMS after WhatsApp fail
`status`	sent \| delivered \| verified \| expired \| failed
`expires_at`	default TTL 10 min
`provider`	always seed

Status

`sent`	accepted
`delivered`	receipt received
`verified`	code OK
`expired`	TTL or attempts
`failed`	send/verify failed

Examples

SEED generates code

1curl -X POST https://api-messages.seed.tg/v1/otp/send \
2  -H "X-API-Key: lks_live_xxx" -H "Content-Type: application/json" \
3  -d '{"to":"+22890000000","reference":"login-1","request_messaging_consent":false}'

You supply code

1curl -X POST https://api-messages.seed.tg/v1/otp/send \
2  -H "X-API-Key: lks_live_xxx" -H "Content-Type: application/json" \
3  -d '{"to":"+22890000000","code":"482917","reference":"login-1","request_messaging_consent":false}'

Verify

1curl -X POST https://api-messages.seed.tg/v1/otp/verify \
2  -H "X-API-Key: lks_live_xxx" -H "Content-Type: application/json" \
3  -d '{"challenge_id":"otp_123","code":"482917"}'

Status

1curl https://api-messages.seed.tg/v1/otp/otp_123 -H "X-API-Key: lks_live_xxx"

WhatsApp only (no SMS fallback)

1curl -X POST https://api-messages.seed.tg/v1/whatsapp/otp/send \
2  -H "X-API-Key: lks_live_xxx" -H "Content-Type: application/json" \
3  -d '{"to":"+22890000000","code":"482917"}'