Karibu OTP API

Briq Digital Limitedtanzanian

Generate, deliver, verify, resend and invalidate one-time passwords over SMS, voice call or WhatsApp with one REST API from Briq.

More identity and kyc APIs Provider documentation

Provider: Briq Digital Limited
Provider origin: tanzanian
Category: Identity and KYC
API version: 2.0.5.13
Available in: Tanzania
Markets: Phone verification, signup and login 2FA, and transaction confirmation for fintech, banking, e-commerce and apps

What it does

The Karibu OTP API generates a numeric code (6 digits by default), delivers it to a phone number by SMS, voice call or WhatsApp, and verifies the code the user submits. Codes are stored hashed, so the plaintext is never returned by the API. Each active OTP allows 3 verification attempts. It is built for backend engineers adding phone verification to signup, login and transaction confirmation. This marketplace lists the API and links out; it does not execute requests on your behalf.

Base URL

Code

https://karibu.briq.tz

Authentication

Every request carries your API key in the X-API-Key header. The key must be bound to a developer app created in the Briq dashboard.

Code

X-API-Key: YOUR_API_KEY
Content-Type: application/json

Endpoints

Issue and verify

POST /v1/otp/request: generate an OTP and deliver it (delivery_method is sms, call or whatsapp).
POST /v1/otp/verify: verify a code submitted by the end user.

Manage

POST /v1/otp/resend: resend the active OTP.
POST /v1/otp/invalidate: invalidate the active OTP for a phone and app.
GET /v1/otp/status: inspect the currently active OTP.

Related APIs

Optional per-request lifecycle callbacks and signed webhooks (/v1/webhooks/*) report delivery events.