# Overzicht van nummers

Een telefoonnummer is waar je berichten en oproepen vandaan komen. Bird verkoopt nummers in de landen die het bedient, en een nummer dat aan je werkruimte is toegewezen kan SMS, MMS of spraak dragen, afhankelijk van wat het nummer ondersteunt. De pagina [**Numbers**](https://bird.com/dashboard/w/numbers) in het dashboard toont de nummers die aan je zijn toegewezen, en dezelfde levenscyclus is beschikbaar via de API: zoek wat er te koop is, bestel er een, bekijk wat je hebt en geef vrij wat je niet meer nodig hebt.

## Dedicated en gedeelde nummers

Elk nummer dat aan je is toegewezen heeft een `kind`, en dat bepaalt wat je met het nummer kunt doen.

Een `dedicated`-nummer is uitsluitend van je werkruimte. Je hebt het gekocht, je betaalt er maandelijkse kosten voor en je kunt het vrijgeven als je klaar bent. Dit is wat het bestellen van een nummer je geeft.

Een `shared`-nummer is een short code op door Bird beheerde infrastructuur. Je krijgt het gebruik ervan in plaats van het te kopen, dus er zijn geen eigen maandelijkse kosten en je kunt het niet vrijgeven. Een poging om er een vrij te geven mislukt met [`E14002`](/docs/api/errors/E14002).

## Wat een nummer kan dragen

Twee velden beschrijven wat een nummer is, en ze beantwoorden verschillende vragen.

`number_type` is het fysieke type van het nummer: `mobile`, `local`, `national`, `toll_free` of een short code. Het bepaalt hoe het nummer zich op het netwerk gedraagt en, in sommige landen, welk papierwerk het vereist.

`capabilities` is wat het nummer daadwerkelijk kan doen: `sms`, `mms`, `voice` of een combinatie. Een nummer met `voice` kan oproepen dragen; een nummer zonder, niet. Filter een zoekopdracht op capability als je een specifieke nodig hebt, en controleer het veld voordat je op een nummer bouwt dat je al hebt.

Een toegewezen nummer is niet altijd genoeg om er vanaf te verzenden. Sommige bestemmingslanden vereisen ook een goedgekeurde registratie voor de afzender, wat een aparte goedkeuring is los van het nummer zelf.

## De status van een toegewezen nummer

`status` geeft aan of een nummer verkeer kan dragen.

`active` betekent dat het nummer aan je is toegewezen en bruikbaar is.

`pending_ownership_registration` betekent dat het nummer aan je is toegewezen en gefactureerd, maar dat een land eigendomsdocumenten vereist die nog niet zijn geaccepteerd. Het veld `ownership` geeft aan wat nog ontbreekt en welke aanroep het verder brengt. De meeste nummers komen nooit in deze status, omdat de meeste landen niets vragen: hun `ownership` is `null`.

`released` betekent dat het nummer niet langer aan je is toegewezen.

## Bestellen is asynchroon

Het bestellen van een nummer maakt een order aan, en de order is wat je volgt. De meeste worden binnen het verzoek afgerond en geven het nummer direct terug. Een order die op een carrier moet wachten komt nog lopend terug, en je pollt deze totdat hij `completed` of `failed` bereikt.

Dit is om twee redenen belangrijk. Een nummer is pas van jou zodra de order `completed` is, dus niets mag ervan uitgaan dat het nummer daarvoor al bestaat. En een eenmalige vergoeding die al in rekening is gebracht wordt niet terugbetaald als een order mislukt. Daarom zijn de zoekopdracht en de order aparte aanroepen: de zoekopdracht laat zien wat beschikbaar is voordat je je vastlegt op de aankoop.

## Volgende stappen

- [Een nummer kopen en vrijgeven](/docs/guides/numbers/buying-numbers) doorloopt de volledige levenscyclus via de API.
- [Numbers API-referentie](/docs/api/reference/list-available-numbers) documenteert elke operatie en elk veld.
- [Idempotency](/docs/guides/idempotency) legt uit hoe je een opnieuw geprobeerde order veilig maakt.

## 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)