# Numbers का अवलोकन

फ़ोन नंबर वह है जिससे आपके मैसेज और कॉल आते हैं। Bird अपने कवर किए गए देशों में नंबर बेचता है, और आपके वर्कस्पेस को आवंटित नंबर SMS, MMS, या वॉइस कैरी कर सकता है, यह इस पर निर्भर करता है कि नंबर क्या सपोर्ट करता है। डैशबोर्ड में [**Numbers**](https://bird.com/dashboard/w/numbers) पेज आपको आवंटित नंबर दिखाता है, और वही लाइफ़साइकल API पर भी उपलब्ध है: देखें क्या बिक्री पर है, एक ऑर्डर करें, अपने मौजूदा नंबर पढ़ें, और जो अब ज़रूरी नहीं उसे रिलीज़ करें।

## डेडिकेटेड और शेयर्ड नंबर

आपको आवंटित हर नंबर का एक `kind` होता है, और यह तय करता है कि आप उस नंबर के साथ क्या कर सकते हैं।

`dedicated` नंबर सिर्फ़ आपके वर्कस्पेस का होता है। आपने इसे खरीदा है, इसके लिए आपसे मासिक शुल्क लिया जाता है, और काम पूरा होने पर आप इसे रिलीज़ कर सकते हैं। नंबर ऑर्डर करने पर आपको यही मिलता है।

`shared` नंबर Bird-प्रबंधित इन्फ़्रास्ट्रक्चर पर एक शॉर्ट कोड होता है। इसे खरीदने के बजाय आपको इसके उपयोग की अनुमति दी जाती है, इसलिए आपका कोई अपना मासिक शुल्क नहीं है और आप इसे रिलीज़ नहीं कर सकते। इसे रिलीज़ करने का प्रयास [`E14002`](/docs/api/errors/E14002) के साथ विफल हो जाता है।

## नंबर क्या कैरी कर सकता है

दो फ़ील्ड बताते हैं कि नंबर क्या है, और वे अलग-अलग सवालों का जवाब देते हैं।

`number_type` नंबर का भौतिक प्रकार है: `mobile`, `local`, `national`, `toll_free`, या शॉर्ट कोड। यह तय करता है कि नंबर नेटवर्क पर कैसे व्यवहार करता है और कई देशों में इसके लिए कौन-सी कागज़ी प्रक्रिया ज़रूरी है।

`capabilities` वह है जो नंबर वास्तव में कर सकता है: `sms`, `mms`, `voice`, या इनका संयोजन। जिस नंबर में `voice` सूचीबद्ध है वह कॉल कैरी कर सकता है; जिसमें नहीं है, वह नहीं कर सकता। जब आपको कोई विशेष क्षमता चाहिए तो सर्च को capability से फ़िल्टर करें, और किसी मौजूदा नंबर पर बनाने से पहले यह फ़ील्ड जाँचें।

आवंटित नंबर होना उससे भेजने के लिए हमेशा पर्याप्त नहीं होता। कुछ गंतव्य देशों में सेंडर के लिए एक स्वीकृत रजिस्ट्रेशन भी चाहिए, जो नंबर से अलग एक स्वतंत्र अनुमोदन है।

## आवंटित नंबर की स्थिति

`status` बताता है कि नंबर ट्रैफ़िक कैरी कर सकता है या नहीं।

`active` का मतलब है कि नंबर आपको आवंटित है और उपयोग योग्य है।

`pending_ownership_registration` का मतलब है कि नंबर आपको आवंटित है और बिल किया जा रहा है, लेकिन किसी देश ने स्वामित्व संबंधी दस्तावेज़ माँगे हैं जो अभी तक स्वीकृत नहीं हुए हैं। `ownership` फ़ील्ड बताती है कि अभी क्या बाकी है और कौन सा कॉल इसे आगे बढ़ाता है। अधिकांश नंबर इस स्थिति में कभी नहीं आते, क्योंकि अधिकांश देश कुछ नहीं माँगते: उनका `ownership` `null` होता है।

`released` का मतलब है कि नंबर अब आपको आवंटित नहीं है।

## ऑर्डर करना असिंक्रोनस है

नंबर ऑर्डर करने से एक ऑर्डर बनता है, और ऑर्डर वह चीज़ है जिसे आप ट्रैक करते हैं। अधिकांश रिक्वेस्ट के अंदर ही पूरे हो जाते हैं और तुरंत नंबर लौटा देते हैं। जिसे कैरियर की प्रतीक्षा करनी होती है वह अभी चल रहा होता है, और आप इसे पोल करते रहते हैं जब तक यह `completed` या `failed` पर नहीं पहुँच जाता।

यह दो कारणों से मायने रखता है। नंबर तभी आपका होता है जब उसका ऑर्डर `completed` हो, इसलिए उससे पहले नंबर के अस्तित्व को मान कर कुछ नहीं करना चाहिए। और एक बार चार्ज हुई सेटअप फ़ीस ऑर्डर विफल होने पर वापस नहीं होती, इसीलिए सर्च और ऑर्डर अलग-अलग कॉल हैं: सर्च आपको बताती है कि खरीदने से पहले क्या उपलब्ध है।

## अगले कदम

- [नंबर खरीदें और रिलीज़ करें](/docs/guides/numbers/buying-numbers) API पर पूरी लाइफ़साइकल दिखाता है।
- [Numbers API संदर्भ](/docs/api/reference/list-available-numbers) हर ऑपरेशन और फ़ील्ड का दस्तावेज़ देता है।
- [Idempotency](/docs/guides/idempotency) बताता है कि फिर से प्रयास किए गए ऑर्डर को सुरक्षित कैसे बनाएँ।

## Related resources

- [What is a virtual phone number (VMN)?](/explained/numbers/what-is-a-virtual-phone-number) (answer)
- [SMS numbers](/sms-api/features/numbers) (product)
- [Number types](/docs/guides/numbers/number-types) (docs)

[Get an implementation brief](/learn/workspace?topic=phone-numbers)