# Nummern – Übersicht Eine Telefonnummer ist der Absender Ihrer Nachrichten und Anrufe. Bird verkauft Nummern in den abgedeckten Ländern, und eine Ihrem Workspace zugewiesene Nummer kann SMS, MMS oder Sprache übertragen, je nachdem, was die Nummer unterstützt. Die Seite [**Numbers**](https://bird.com/dashboard/w/numbers) im Dashboard zeigt die Ihnen zugewiesenen Nummern, und derselbe Lebenszyklus steht über die API zur Verfügung: suchen, was im Angebot ist, eine bestellen, lesen, was Sie haben, und freigeben, was Sie nicht mehr brauchen. ## Dedizierte und geteilte Nummern Jede Ihnen zugewiesene Nummer hat einen `kind`, und dieser bestimmt, was Sie mit der Nummer tun können. Eine `dedicated`-Nummer gehört ausschließlich Ihrem Workspace. Sie haben sie gekauft, zahlen eine monatliche Gebühr dafür und können sie freigeben, wenn Sie sie nicht mehr benötigen. Das ist es, was das Bestellen einer Nummer Ihnen gibt. Eine `shared`-Nummer ist ein Short Code auf von Bird verwalteter Infrastruktur. Sie erhalten ein Nutzungsrecht, statt sie zu kaufen. Daher fällt keine eigene monatliche Gebühr an, und Sie können sie nicht freigeben. Der Versuch, eine solche Nummer freizugeben, schlägt mit [`E14002`](/docs/api/errors/E14002) fehl. ## Was eine Nummer übertragen kann Zwei Felder beschreiben, was eine Nummer ist, und sie beantworten unterschiedliche Fragen. `number_type` ist die physische Art der Nummer: `mobile`, `local`, `national`, `toll_free` oder ein Short Code. Das Feld bestimmt, wie sich die Nummer im Netzwerk verhält und in einigen Ländern, welche Dokumente sie erfordert. `capabilities` beschreibt, was die Nummer tatsächlich kann: `sms`, `mms`, `voice` oder eine Kombination. Eine Nummer, die `voice` auflistet, kann Anrufe übertragen; eine ohne diesen Eintrag nicht. Filtern Sie eine Suche nach Fähigkeit, wenn Sie eine bestimmte benötigen, und prüfen Sie das Feld, bevor Sie auf einer bereits vorhandenen Nummer aufbauen. Eine zugewiesene Nummer reicht nicht immer aus, um von ihr zu senden. Einige Zielländer verlangen zusätzlich eine genehmigte Registrierung für den Absender, die unabhängig von der Nummer selbst erteilt wird. ## Der Status einer zugewiesenen Nummer `status` gibt an, ob eine Nummer Verkehr übertragen kann. `active` bedeutet, dass die Nummer Ihnen zugewiesen und nutzbar ist. `pending_ownership_registration` bedeutet, dass die Nummer Ihnen zugewiesen und abgerechnet wird, ein Land aber Eigentumsnachweise verlangt, die noch nicht akzeptiert wurden. Das Feld `ownership` gibt an, was noch aussteht und welcher Aufruf den Vorgang weiterbringt. Die meisten Nummern erreichen diesen Status nie, weil die meisten Länder nichts verlangen: Ihr `ownership` ist `null`. `released` bedeutet, dass die Nummer Ihnen nicht mehr zugewiesen ist. ## Die Bestellung ist asynchron Das Bestellen einer Nummer erzeugt eine Bestellung, und die Bestellung ist das Objekt, das Sie verfolgen. Die meisten werden innerhalb des Requests abgeschlossen und liefern die Nummer sofort zurück. Eine Bestellung, die auf einen Carrier warten muss, kommt noch laufend zurück, und Sie pollen sie, bis sie `completed` oder `failed` erreicht. Das ist aus zwei Gründen wichtig. Eine Nummer gehört Ihnen erst, wenn ihre Bestellung `completed` ist, also sollte nichts davon ausgehen, dass die Nummer vorher existiert. Und eine bereits berechnete Einrichtungsgebühr wird bei fehlgeschlagener Bestellung nicht erstattet. Deshalb sind Suche und Bestellung getrennte Aufrufe: Die Suche zeigt Ihnen, was verfügbar ist, bevor Sie sich zum Kauf verpflichten. ## Nächste Schritte - [Eine Nummer kaufen und freigeben](/docs/guides/numbers/buying-numbers) führt den vollständigen Lebenszyklus über die API durch. - [Numbers-API-Referenz](/docs/api/reference/list-available-numbers) dokumentiert jede Operation und jedes Feld. - [Idempotenz](/docs/guides/idempotency) erklärt, wie Sie eine wiederholte Bestellung sicher machen. ## 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)