# International Numbers
URL: /docs/phone-numbers/international
LLM index: /llms.txt
Description: US and Canada numbers are available via API. Numbers in other countries are available through support on request.

# International Numbers

Surge's API supports purchasing and managing phone numbers in the United States and Canada. Numbers in other countries are available on a case-by-case basis through support.

## US and Canada

Local numbers for US and Canadian area codes are available via the API:

<CodeGroup items={["Python","TypeScript","Ruby","Elixir","cURL"]}>

```python Python
from surge import Surge

surge = Surge()

number = surge.phone_numbers.purchase(
    account_id="{account_id}",
    type="local",
    area_code="416",
)
```

```typescript TypeScript
import Surge from "@surgeapi/node";

const surge = new Surge();

const number = await surge.phoneNumbers.purchase("{account_id}", {
  type: "local",
  area_code: "416",
});
```

```ruby Ruby
require "surge_api"

surge = SurgeAPI::Client.new

number = surge.phone_numbers.purchase(
  "{account_id}",
  type: "local",
  area_code: "416"
)
```

```elixir Elixir
client = Surge.Client.new(System.get_env("SURGE_API_KEY"))

{:ok, number} =
  Surge.PhoneNumbers.purchase(client, "{account_id}", %{
    type: "local",
    area_code: "416"
  })
```

```bash cURL
curl -X POST https://api.surge.app/accounts/{account_id}/phone_numbers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "local",
    "area_code": "416"
  }'
```

</CodeGroup>

Canadian numbers follow the same 10-digit NANP format as US numbers. The `identifier_type` for Canadian business registration is `cbn` (Canadian Business Number). See the [Schema Reference](../registration/schema-reference) for details.

## Other countries

<Info>
For phone numbers outside the US and Canada, contact Surge support. International numbers are reviewed individually and availability varies by country.
</Info>

What to include in your support request:
- The country and region you need a number in
- Your use case (SMS, voice, or both)
- Expected monthly message volume
- Your existing business registration in that country (if applicable)

## Regulatory considerations

Carrier regulations differ significantly by country. SMS spam laws, opt-in requirements, and registration requirements outside North America vary, and in some markets they're stricter than the US A2P 10DLC framework. Surge's support team can advise on what's required for your target country before you begin the purchasing process.