Python based script to search your account for unused numbers and release them.
Switch branches/tags
Nothing to show
Clone or download
dotmat Update
Modified for Python3, should be faster and connect to the Twilio API with higher throughput
Latest commit c02adcb Jan 22, 2016
Failed to load latest commit information.
LICENSE Initial commit Dec 21, 2015 Update Jan 22, 2016 Update Dec 21, 2015


Unused number hunter is Pyton based script to help you release (and save some $$$'s) on unused numbers that may be sitting in your Twilio account.

If you are in the habbit of buying Twlio numbers, using them for a project and then not relasing them this script will be the tool for you.

How to use:

  • Download the python script to a directory
  • Ensure you have the Twilio Python helper library installed, you can find this at:
  • Edit the Accountsid, Authkey and number of call records you want to examine, saving the script.
  • Run: python /directory/

What will happen:

  • NumberHunter will grab all the phone numbers from your Twilio account, storing the numbers in a txt file called: TwilioNumbersInAccount.txt
  • NumberHunter will grab a copy of the call records up to the number (default is 100) you want to examine. (Saved in TwilioCallLog.txt)
  • NumberHunter will compare numbers in your call log against your Twilio numbers
  • NumberHunter will save a copy of your unused numbers in a file called unusedTwilioNumbers.txt
  • NumberHunter will ask you if you want to release these numbers - If you select Y it WILL REMOVE these numbers from your account immediately.

Happy Hunting!

TL:DR : Python based script to search your account for unused numbers and release them.