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

# Buy Numbers

> Purchase phone numbers from the itellicoAI marketplace

export const Screenshot = ({lightSrc, darkSrc, alt, caption, maxWidth = "880px"}) => {
  return <div style={{
    margin: "1rem auto",
    maxWidth,
    width: "100%"
  }}>
      <Frame>
        <img className="block dark:hidden" src={lightSrc} alt={alt} />
        <img className="hidden dark:block" src={darkSrc} alt={alt} />
      </Frame>
      {caption ? <p style={{
    marginTop: "0.5rem",
    fontSize: "0.875rem",
    color: "inherit",
    opacity: 0.8
  }}>
          {caption}
        </p> : null}
    </div>;
};

<Note>
  Buying numbers through the interface is straightforward for most cases, but compliance requirements can sometimes make it tricky — especially for certain countries or number types. If you run into any issues or just want help, contact us at [support@itellico.ai](mailto:support@itellico.ai) and let us know what you need. We'll take care of it.
</Note>

The fastest way to get phone numbers for your AI agents is buying them directly from the itellicoAI marketplace. Numbers are yours once purchased; you can use them for as long as your subscription is active. We handle the telephony infrastructure — you just pick a number and assign an agent.

**Access:** Go to **Telephony → Buy Number**, or open **Telephony → Phone Numbers** and click **Add Number → Buy a Number**.

The current marketplace UI exposes supported DACH countries: Austria, Germany, and Switzerland. Additional countries may be added as carrier coverage expands.

<Screenshot lightSrc="/images/telephony__buy-number-light.png" darkSrc="/images/telephony__buy-number-dark.png" alt="Number marketplace showing country selection, number type, pricing, and search results" />

## How to Buy a Number

<Steps>
  <Step title="Open the marketplace">
    Go to **Telephony → Buy Number**, or open **Telephony → Phone Numbers** and click **Add Number → Buy a Number**.
  </Step>

  <Step title="Select country and number type">
    Choose a supported country from the dropdown, then select one or more number types such as local, national, mobile, or toll-free. Available types depend on the country.
  </Step>

  <Step title="Check pricing and compliance">
    The marketplace shows the **monthly price** for your selection. If a [compliance profile](/phone-numbers/regulatory-bundles) is required for that country, you'll see a notice — you must have an approved profile before purchasing.
  </Step>

  <Step title="Search for numbers">
    Optionally search by digits or prefix (e.g., "720" or "555") to find specific numbers. Results show up to 50 matching numbers with type, location, monthly price, and purchase action.
  </Step>

  <Step title="Purchase">
    Click **Purchase** on your chosen number. Checkout opens in a separate secure payment flow. After checkout, you return to [Phone Numbers](/launch/phone-numbers), where the number can briefly show as provisioning before it is fully available.
  </Step>
</Steps>

<Tip>
  Some countries show masked numbers (partially hidden) until purchase. You'll see the prefix and area code, but the full number is assigned after checkout.
</Tip>

## After Purchase

Once your number is provisioned:

1. Open [Phone Numbers](/launch/phone-numbers) to find your new number
2. Open the number's **Routing** settings to assign an agent
3. Optionally add a **Label** for easy identification
4. Test a call to verify everything works

<Note>
  If checkout succeeds but provisioning is still running, the Phone Numbers page shows a temporary status notice until the number is ready.
</Note>

## Next Steps

<CardGroup cols={2}>
  <Card title="Phone Numbers" icon="phone" href="/launch/phone-numbers">
    Manage and configure your numbers
  </Card>

  <Card title="Compliance Profiles" icon="file-certificate" href="/phone-numbers/regulatory-bundles">
    Meet compliance requirements for regulated countries
  </Card>

  <Card title="Agent Editor" icon="pen-to-square" href="/build/getting-started/agent-editor">
    Configure the agent that answers calls
  </Card>
</CardGroup>