---
title: Metadata of a phone number
slug: voice-apis/metadata-of-a-phone-number
docTags: 
createdAt: 2025-10-11T04:39:04.189Z
---

The number metadata API provides the following metadata of a given number:

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

If all you want is to see/read the details of a phone number, use our [Phone number details page](http://exotel.in/phone-number-dnd-location-operator-details/)

**Request Format:**

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/vLJNCpTUzLYglWkFn4b6s-20260729-074331.png?1616739465)

https\://\<your\_api\_key>:\<your\_api\_token>\<subdomain>/v1/Accounts/\<your\_sid>/Numbers/\~number\~

- Replace \<your\_api\_key> and \<your\_api\_token> with the API key and token created by you.
- Replace \<your\_sid> with your “Account sid”
- Replace \<subdomain>with the region of your account
  - \<subdomain> of Singapore cluster is api.exotel.com
  - \<subdomain> of Mumbai cluster is api.in.exotel.com

\<your\_api\_key> , \<your\_api\_token> and \<your\_sid>onExotel Dashboard

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

**Response:&#x20;**

The response comes back in XML

| **Parameter Name**            | **VALUE**                                                                                                                                                                                                                                                                                          |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| PhoneNumber                   | Reformatted phone number string                                                                                                                                                                                                                                                                    |
| Circle<br />                  | Two-character [telecom circle code](http://en.wikipedia.org/wiki/Mobile_telephone_numbering_in_India).                                                                                                                                                                                             |
| CircleName<br />              | The human-readable string of the Circle code.<br />Ex: Haryana Telecom Circle (excludes Faridabad, Gurgaon & Panchkula)                                                                                                                                                                            |
| Type<br />                    | 'Mobile' or 'Landline'                                                                                                                                                                                                                                                                             |
| Operator & OperatorName<br /> | "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'<br />'No'<br />'Unavailable'                                                                                                                                                                                                                                                                 |

**Example:**

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/0u6IhdHX31gFA1bTCxmWh-20260729-074330.png?1616739319)

**Please note the DND status fetched using the mentioned API may not be accurate as the DND statuses are not published as per recent updates by TRAI.**