getsmscode

API client for getsmscode.com.

• provides temporary, physical mobile numbers (not virtual VOIP numbers!)
• meant for automated systems that need to bypass SMS number verification
• handles hundreds of known services (wechat, google, facebook, whatsapp, uber, twitter, etc...)

Install

This module requires node >= 8.

npm install --save getsmscode

You'll need to setup a getsmscode.com account and add some money to your account before using this module.

Usage

constGetSMSCodeClient=require('getsmscode')constclient=newGetSMSCodeClient({username: '...',token: '...'})constnumber=awaitclient.getNumber({service: 'google'})// give this number to third-party service such as google...// third-party service sends SMS code to the given number...constsms=awaitclient.getSMS({service: 'google',number: number})

Note: there may be variable amounts of latency between giving your number to the service and the SMS code being received. If no valid messages are returned, it is recommended that you retry client.getSMS with an exponential timeout. Be careful not to call the API too fast, however, as getsmscode imposes strict rate limits.

API

GetSMSCodeClient

Type: function (opts)

• optsobject? Config options
  • opts.usernamestring Username for getsmscode auth (optional, default process.env.GETSMSCODE_USERNAME)
  • opts.tokenstring Token for getsmscode auth (optional, default process.env.GETSMSCODE_TOKEN)
  • opts.domainstring Domain for this client to use (china/usa/asia) (optional, default 'china')

---

login

Logs in to test auth and fetches an account summary.

Type: function (): Promise

---

getNumber

Acquires a temporary handle on a mobile number usable for the given service.

You must specify either opts.service or opts.pid.

Type: function (opts): Promise

• optsobject Config options
  • opts.servicestring? Name of service to blacklist number
  • opts.pidstring? Project ID of service to blacklist number
  • opts.cocodestring? Country code (required if using asian domain)

---

getNumbers

Returns a list of { number, service } objects currently in use by this account.

Type: function (): Promise

---

getSMS

You must specify either opts.service or opts.pid.

Type: function (opts): Promise

• optsobject Config options
  • opts.numberstring Mobile number to blacklist
  • opts.servicestring? Name of service to blacklist number
  • opts.pidstring? Project ID of service to blacklist number
  • opts.cocodestring? Country code (required if using asian domain)

---

addNumberToBlacklist

Adds a number to this account's blacklist for the given service.

You must specify either opts.service or opts.pid.

Type: function (opts): Promise

• optsobject Config options
  • opts.numberstring Mobile number to blacklist
  • opts.servicestring? Name of service to blacklist number
  • opts.pidstring? Project ID of service to blacklist number
  • opts.cocodestring? Country code (required if using asian domain)

Related

• sms-number-verifier - Allows you to spoof SMS number verification.
• parse-otp-message - Parses OTP messages for a verification code and service provider.

Disclaimer

Using this software to violate the terms and conditions of any third-party service is strictly against the intent of this software. By using this software, you are acknowledging this fact and absolving the author or any potential liability or wrongdoing it may cause. This software is meant for testing and experimental purposes only, so please act responsibly.

License

MIT © Travis Fischer

Support my OSS work by following me on twitter