API Reference/2. Check Verification Status
1 min read
2. Check Verification Status
Query the status of the current verification session.
Once the verification process starts and you get the requestId, your application must continuously poll the session status to see if the customer has successfully sent the message.
Working Mechanism (Polling):
- Make a
GETrequest to the specified endpoint every 3 seconds.
- As soon as you get the status
"VERIFIED", stop polling immediately and log the user in successfully.
Returned States (Session States):
PENDING: The customer hasn't sent the message yet. Keep polling.
VERIFIED: The message was sent and the number was successfully verified.
EXPIRED: Expired (maximum 5 minutes after server wakeup).
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"
}'