ReOTP.
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 GET request 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)
curl -X GET https://[your-domain.com]/api/verify/status?id=YOUR_REQUEST_ID

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"
  }'