Sign Up Now For A Free Trial

Phone Info API

Get information about a phone number such as the carrier and SMS/MMS email addresses when available.

Cost: 10 tokens per request ($0.00667 - $0.01)

Request

URL: http://api.twolbox.com/2011-1-1/phone-info

Please note that parameters are case sensitive.

Parameter NameDescription 
authIdYour TwolBox Auth ID.Required
authTokenYour TwolBox Auth Token.Required
numberNorth American phone number.Required

Response

The response is sent in JSON format.

NameValue
status"OK" or "ERROR".
statusCodeInteger response code for easier automated processing.
  • 200: OK
  • 400: Validation Error
  • 401: Unauthorized (invalid credentials)
  • 402: Payment Required
errorsAn array of error messages or an empty array if there were no errors.
numberPhone number.
carrierCurrent carrier.
typeCarrier type.
smsEmailEmail sent to this address will be translated to a text message and sent to the phone.
mmsEmailEmail sent to this address will be translated to a multi-media message and sent to the phone.

You can quickly and easily integrate our API into your Twilio handler. Just fill in a few fields and we'll cook up a custom recipe for you to drop in!

 

Request

Parameter NameValueDescription
Your TwolBox Auth ID.
Your TwolBox Auth Token.
North American phone number.

Response

NameValue