API Reference/2. Check Status
1 min read
2. Check Status
Query the status of the ongoing verification session.
Once the verification process is initialized and you get a requestId, your frontend needs to check (Poll) the endpoint periodically to know if the user has sent the message.
Polling Mechanism:
- Make a
GETrequest to the status endpoint every 3 seconds.
- Once you receive the
"VERIFIED"status, stop polling and log the user in.
Returned Session Statuses:
PENDING: The user has not sent the verification message yet. Continue polling.
VERIFIED: The message was received, and the number is verified.
EXPIRED: The session has timed out (usually 2 minutes after initiation).
Integration Code (SDKs)
Interactive Live API Playground
Test verification requests live and generate integration code in your preferred programming language.
curl -X POST https://reotp.com/api/verify/init \
-H "Authorization: Bearer 15a1c1c7-ed05-40df-b7c3-69c327542a07" \
-H "Content-Type: application/json" \
-d '{
"phoneNumber": "201000000000",
"method": "WHATSAPP"
}'