> ## 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. # Buying phone numbers > Search, buy, and manage numbers through the platform marketplace The platform includes a **number marketplace**: search available numbers by country and type, buy them in a click, and they are routed to your account's telephony automatically — no carrier account needed. ## How buying works Phone number marketplace search with country, number pattern and Local or Mobile filters Go to **Settings → Numbers → Add a number → Buy a number** and pick a country. When more than one number type is buyable, or you have a workspace/user regulatory bundle, tabs appear above the list (Local, Mobile, and your bundle name). A single type with only a global unlock shows every available number with no tabs — same as before. Many countries legally require identity or address verification before a number can be activated — see below. The monthly price and any setup fee are shown up front. Complete the secure checkout. The number remains pending and cannot receive or place calls until payment is confirmed. You can optionally assign an assistant during purchase. Only assistants without an inbound number are shown; pending number reservations also count. You can leave the number unassigned and connect an assistant later. A verified payment event provisions routing and activates the number. Failed, expired, or unpaid purchases automatically release the held number and grant no call access. Point the number at an assistant — inbound calls are answered from that second on. The same number can be used as outbound caller ID. ## Country availability & pricing Available countries and number types are shown in the marketplace. It sells **local, mobile, and national** numbers; **toll-free is not currently sold**. The checkout shows the monthly price and any one-time setup fee before purchase. Prices differ by country and number type. **Pricing & checkout:** The live price and setup fee displayed in the checkout modal are authoritative. Older marketing landing pages citing €2/month are outdated. For example, standard German local numbers (Ortsnetz) are currently **€2.50/month + a one-time setup fee of €5.99**. ## German local numbers (Ortsnetz) German local phone numbers are subject to specific regulatory and inventory rules: * **Live marketplace stock:** Availability reflects live network inventory. Numbers in major metropolitan area codes such as Berlin (`+49 30` / `030`) and Stuttgart (`+49 711` / `0711`) are commonly stocked and immediately available for purchase. * **Specific or missing area codes:** Germany has over 5,200 local area codes. If a specific area code (for example `07274` Germersheim) does not currently show available numbers in the general list: 1. **Search with area code:** Enter the specific local prefix into the marketplace search bar. 2. **Submit regulatory verification:** German telecommunications law (TKG) mandates a verifiable physical address within the corresponding municipal area code. Go to **Settings → Verification**, select Germany, number type Local, and enter the prefix in international format (e.g. `07274` as `+497274`) along with your local address documentation. 3. **Custom provisioning:** If an approved area code has no live inventory in the self-service marketplace, ask Milian in your dashboard to open a provisioning ticket. As a carrier, we provision numbers directly from our reserve pools for your verified municipality. ## Regulatory bundles Some countries and number types require **identity verification** before you can buy. The buy page shows only the types that are still locked. Everything else can be purchased immediately. After regulatory approval, eligible numbers become available for purchase and calling. ### How to verify 1. Open **Settings → Verification** (or **Buy a number → Custom number / Submit verification**). 2. The country list includes countries that require regulatory verification. API clients can use `GET /api/v1/phone-numbers/verifications/catalog`. 3. Choose country, number type, end-user type (business or individual), and the required area code or prefix. National digits such as 0831 become +49831 for Germany. The form fields and accepted documents are loaded **for that combination** from the live regulation catalog. 4. Submit the case. Status updates appear on the Verification page (`pending review` → `approved` / `rejected`). If a case fails the automated check or is rejected, click **Fix & resubmit**: the form opens with your last details and documents, with the reasons shown at the top. Correct what they name, replace a document only if needed, and submit again. The case is updated instead of a new one being opened. If a verification for the same country, number type and area code is already in review or verified, the form warns you before sending a second one. If the registration asks for an authorized representative, enter their name exactly as it appears on the uploaded ID. 5. After approval, marketplace search/purchase for that country and type is unlocked for the workspace. Click a case or its status to see where it stands: **Submitted → Automated check → Regulatory review → Verified → Buy a number**. While the review runs, that step is animated and shows since when it has been waiting. After approval, the last step links straight to numbers with the verified area code and shows the city and current availability. You can also: * List catalog / cases via the public API (`/api/v1/phone-numbers/verifications`, `/api/v1/phone-numbers/verifications/catalog`) * Delete a draft or failed case with `DELETE /api/v1/phone-numbers/verifications/{id}` * Read a case's progress with `GET /api/v1/phone-numbers/verifications/{id}`: the response includes a `timeline` with the same steps. A case's `status` is one of `draft`, `pending_review`, `in_review`, `provisionally_approved`, `approved`, `rejected`, `failed`. * Correct and resubmit your own failed or rejected case with `POST /api/v1/phone-numbers/verifications` and `replace_verification_id`. `GET /api/v1/phone-numbers/verifications/{id}/submission` returns its last details; documents you don't attach again are reused. * Use MCP tools `list_verification_catalog`, `list_number_verifications`, `submit_number_verification` (with `replace_verification_id` to resubmit), `get_number_verification` (includes the progress timeline; with `include_submission` for the last details), `delete_number_verification` Plan ahead for regulated countries: review often takes a few business days (varies by country and document quality). ## Outbound SMS SMS-capable numbers (marketplace mobile numbers, or Twilio-imported numbers with SMS capability) can send outbound SMS through the platform after you enable **Allow outbound SMS** on the number’s SMS tab. * **Marketplace numbers:** SMS credits include the platform fee plus carrier pass-through. * **Twilio BYOC import:** SMS credits charge only the platform fee; Twilio carrier cost is billed on your Twilio account. For US 10DLC → US traffic, the number must be registered with an approved A2P 10DLC campaign in Twilio. Public API: `POST /api/v1/sms/send`. MCP: `send_sms`. See [SMS](/api-reference/sms) for per-segment billing and the send API. ## Complimentary (plan free) numbers Some plans include a limited number of complimentary **local** marketplace numbers for selected countries. Mobile, national, and other number types remain paid. If the workspace plan is canceled or payment remains overdue, complimentary numbers are released automatically. Paid marketplace numbers are unaffected. Manual release of a complimentary number is **immediate** and cannot be undone. ## Releasing a paid marketplace number When you release a paid marketplace number: 1. Renewal is canceled at the end of the current billing period. 2. The number **stays fully usable** (inbound/outbound) until that period end. 3. At period end, the number is released and can no longer be used. Complimentary / unpaid / failed purchases are still released immediately. There is **no refund** and **no proration** — the setup fee is one-time and is never returned. ## Phone number limits & plan allowances Your plan determines your quota for verified Caller IDs and complimentary marketplace numbers. Purchasing additional marketplace numbers and connecting SIP trunks are never limited by these quotas. | Plan | Monthly price | Verified Caller IDs | Complimentary marketplace DIDs | Marketplace numbers & SIP trunks | | - | - | - | - | - | | **Prepaid** | Pay-as-you-go | 0 active slots (verification blocked until upgraded) | 0 | Unlimited | | **Plus** | €35/mo | **5** | 0 | Unlimited | | **Pro** | €129/mo | **10** | 0 | Unlimited | | **Agency** | €259/mo | **20** | **3** (local DIDs in AT, CA, DE, FR, GB, US) | Unlimited | ### Understanding number types and quotas * **Verified Caller IDs:** Numbers you already own outside Famulor, verified once via phone call to present on outbound calls. These do not incur monthly number fees. Prepaid workspaces use the platform default quota; if verification is blocked with 0 slots, upgrade to a plan that includes Caller IDs (Plus 5, Pro 10, Agency 20). * **Complimentary marketplace DIDs:** Full inbound and outbound marketplace numbers whose monthly rental fee is included with your plan. On the Agency plan, up to 3 local numbers in eligible countries (AT, CA, DE, FR, GB, US) are included at no extra monthly rental cost. * **Marketplace number capacity:** You can buy and connect as many marketplace phone numbers as you need (unlimited across all plans, including Prepaid). Every purchased number is simply billed at its active marketplace monthly rate. Carrier imports and BYO SIP trunks are likewise unlimited. ## Carrier costs on calls Besides the monthly number fee, call-minute pricing can vary by destination country. See [How minutes are billed](/billing/minutes). ## Choosing how to connect a number Add a number menu with marketplace, SIP, carrier import and caller ID verification options The marketplace isn't the only way to get a number working with an assistant: | Option | Direction | What it needs | | - | - | - | | **Buy from the marketplace** (this page) | Inbound + outbound | Nothing to bring — search, buy, assign (regulated countries need verification first) | | **[BYO SIP trunk](/telephony/sip-trunks)** | Inbound + outbound | A number you already own at a SIP-compatible carrier | | **[Carrier import](/telephony/carrier-import)** | Inbound + outbound | A Twilio, Telnyx, or Vonage account — routing is set up for you | | **[Verify a caller ID](/telephony/caller-id)** | Outbound only | A phone number you already own, verified once — no porting or SIP setup | Buy a marketplace number for a new setup. Bring your own SIP trunk when you already have carrier numbers you want to keep using — or let carrier import wire them up automatically if those numbers live at Twilio, Telnyx, or Vonage. Verify a caller ID when you only need your own number to show up on outbound calls — for example, an outbound sales campaign that doesn't need to receive calls. Want the line you already answer today to reach an assistant instead? Keep that number where it is and [forward it to your Famulor number](/telephony/call-forwarding-setup). ### Choose the right registration The available registration types depend on the country and number type. German local and mobile numbers currently support business registration only; individual registration is unavailable. The form only offers supported options. Use the exact legal name, registration number, and address shown on your supporting document. Registered companies should provide a commercial register extract; freelance businesses can use the accepted official tax-registration notice. API and MCP clients can retrieve the same fields and document requirements with `GET /phone-numbers/verifications/requirements` or `get_number_verification_requirements`. First consult the verification catalog for supported combinations. An unavailable registration type cannot be submitted. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.