Mobile ownership by OTP

Proves the person holds the number and returns the subscriber details on record.

What you can do with it

  1. Prove at sign-up that the customer holds the number they gave.

  2. Compare the subscriber details held by the telecom operator with the customer’s ID.

  3. Re-confirm the number before changing payout or contact details.

How it works

Step 1: Mobile ownership: send OTP

POST /v1/verify/mobile/otp

What you send

  • mobilerequired10-digit Indian mobile number starting 6 to 9; a leading +91, 91 or 0 and spaces are ignored.

What you get back

  • reference_idReference for this OTP. Send it back, with the OTP the person receives, to /v1/verify/mobile/otp/verify.
Full API reference

Step 2: Mobile ownership: verify OTP

POST /v1/verify/mobile/otp/verify

What you send

  • mobilerequired10-digit Indian mobile number starting 6 to 9; a leading +91, 91 or 0 and spaces are ignored. Must be the number the OTP was sent to.
  • reference_idrequiredThe reference_id returned by /v1/verify/mobile/otp, 6 to 80 letters, digits, hyphens or underscores.
  • otprequiredThe OTP the person received, 4 to 8 digits.

What you get back

  • nameSubscriber name on the telecom record.
  • addressSubscriber address on the telecom record.
  • split_addressThe subscriber's address broken into parts.
  • split_address.districtDistrict name, as a list.
  • split_address.stateState name, as a list.
  • split_address.cityCity name, as a list.
  • split_address.pincodeSix-digit pincode.
  • split_address.countryCountry name, as a list.

and 13 more

Full API reference

Start using Mobile ownership by OTP

Add money to your wallet, subscribe to Mobile ownership by OTP and we switch it on for your account. You call it with your own key.