This API provides the following metadata given a number:

  • Telecom Circle 
  • Human readable Telecom Circle name 
  • Number type 
  • Operator (Carrier) that this number belongs to
  • Whether the number belongs to DND or not

If all you want is to see/read the details of a phone number, use our Phone number details page.


Request Format:


GET Request to https://~exotel_sid~:~exotel_token~@api.exotel.com/v1/Accounts/~exotel_sid~/Numbers/~number~


Replace ~exotel_sid~ and ~exotel_token~ with the values you obtain from the Exotel Settings tab of your Exotel portal

Example:
https://roopit:afancytokenwordhere007@api.exotel.com/v1/Accounts/roopit/Numbers/9916766748


Response: 


Response comes back in XML


TAG NAME VALUE
PhoneNumber Reformatted phone number string
Circle
Two character telecom circle code.
CircleName
Human readable string of the Circle code.
Ex: Haryana Telecom Circle (excludes Faridabad, Gurgaon & Panchkula)
Type
'Mobile' or 'Landline'
Operator & OperatorName
   "AC" => "Aircel",
    "A"  => "Airtel",
    "AL" => "Allianz",
    "B"  => "BSNL",
    "D"  => "Dishnet",
    "E"  => "Etisalat",
    "H"  => "HFCL",
    "I"  => "Idea",
    "LO" => "Loop",
    "MT" => "MTNL",
    "P"  => "Ping",
    "R"  => "Reliance",
    "S"  => "Sistema",
    "ST" => "S Tel",
    "T"  => "Tata",
    "U"  => "Unitech",
    "VI" => "Videocon",
    "V"  => "Vodafone"
 DND 'Yes'
'No'
'Unavailable'


Example:


<TwilioResponse>
 <Numbers>
 <PhoneNumber>08686888888 </PhoneNumber>
 <Circle>AP</Circle>
 <CircleName>Andhra Pradesh Telecom Circle</CircleName>
 <Type>Mobile</Type>
 <Operator>AC</Operator>
 <OperatorName>Aircel</OperatorName>
 <DND>No</DND>
 </Numbers>
</TwilioResponse>