> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Telefonnummer kaufen

> Kaufe eine dedizierte Telefonnummer in Famulor per API. Lokale, mobile oder gebührenfreie Rufnummern für Inbound- oder Outbound-KI-Telefonate.

Dieser Endpunkt ermöglicht es dir, eine Telefonnummer zu kaufen, die über den [Such-Endpunkt](/de/api-reference/phone-numbers/search) gefunden wurde. Die Plattform übernimmt automatisch Preisgestaltung, Abrechnung und Bereitstellung.

<Note>
  Du musst eine gültige Zahlungsmethode hinterlegt haben, bevor du eine Telefonnummer kaufen kannst. Der Kauf erstellt ein monatliches Abonnement, das automatisch verlängert wird.
</Note>

### Request Body

<ParamField body="phone_number" type="string" required>
  Die zu kaufende Telefonnummer im E.164-Format (z.B. +14155551234). Muss eine Nummer sein, die vom Such-Endpunkt zurückgegeben wurde.
</ParamField>

### Antwort-Felder

<ResponseField name="message" type="string">
  Erfolgsmeldung
</ResponseField>

<ResponseField name="data" type="object">
  Die Details der gekauften Telefonnummer

  <Expandable title="Daten-Eigenschaften">
    <ResponseField name="id" type="integer">
      Die eindeutige Kennung der Telefonnummer
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      Die Telefonnummer im E.164-Format
    </ResponseField>

    <ResponseField name="country_code" type="string">
      Der ISO-Ländercode
    </ResponseField>

    <ResponseField name="type" type="string">
      Der Telefonnummerntyp (immer `normal` für gekaufte Nummern)
    </ResponseField>

    <ResponseField name="sms_capable" type="boolean">
      Ob die Nummer SMS unterstützt
    </ResponseField>
  </Expandable>
</ResponseField>

### Funktionsweise

1. **Suchen** - Verwende zuerst den [Such-Endpunkt](/de/api-reference/phone-numbers/search), um verfügbare Nummern zu finden
2. **Kaufen** - Übermittle die gewünschte Telefonnummer an diesen Endpunkt
3. **Automatische Verarbeitung** - Die Plattform:
   * Validiert, dass die Nummer noch verfügbar ist
   * Bestimmt den korrekten Preis basierend auf dem Land
   * Erstellt ein monatliches Abonnement auf deiner Zahlungsmethode
   * Stellt die Nummer bei unserem Telefonieanbieter bereit
   * Erstellt den Telefonnummern-Datensatz in deinem Konto

<Warning>
  Telefonnummern-Käufe sind nicht erstattungsfähig. Das Abonnement wird fortgesetzt, bis du die Nummer [freigibst](/de/api-reference/phone-numbers/release).
</Warning>

<ResponseExample>
  ```json 201 Created theme={null}
  {
    "message": "Phone number purchased successfully.",
    "data": {
      "id": 123,
      "phone_number": "+14155551234",
      "country_code": "US",
      "type": "normal",
      "sms_capable": true
    }
  }
  ```

  ```json 400 Already In Use theme={null}
  {
    "error": "This phone number is already in use."
  }
  ```

  ```json 400 Not Available theme={null}
  {
    "error": "This phone number is not available for purchase. Please search for available numbers first."
  }
  ```

  ```json 402 No Payment Method theme={null}
  {
    "error": "No payment method found. Please add a payment method to your account."
  }
  ```

  ```json 402 Payment Failed theme={null}
  {
    "error": "Payment failed. Please update your payment method."
  }
  ```

  ```json 422 Invalid Format theme={null}
  {
    "error": "Unable to parse phone number. Please provide a valid E.164 format number."
  }
  ```

  ```json 500 Provider Error theme={null}
  {
    "error": "Failed to purchase phone number from provider. Please contact support."
  }
  ```
</ResponseExample>