# sinch numbers

Manage Sinch phone numbers: search available numbers, view active numbers, update configuration, and release numbers. See [Sinch Numbers API](/docs/numbers/) on developers.sinch.com for product documentation.

## sinch numbers active

Manage phone numbers currently active in your project.

### sinch numbers active list

List all active phone numbers, with optional filters.


```sh
sinch numbers active list [options]
```

| Option | Description |
|  --- | --- |
| `-r, --region <code>` | Filter by region code (e.g., `US`, `GB`, `SE`) |
| `-t, --type <type>` | Filter by type: `MOBILE`, `LOCAL`, or `TOLL_FREE` |
| `-c, --capability <cap...>` | Filter by capability: `SMS`, `VOICE` |
| `-p, --pattern <digits>` | Filter by digit pattern |
| `--search-pattern <mode>` | Pattern match mode: `START`, `CONTAINS`, or `END` |
| `-l, --limit <number>` | Maximum results to return |
| `--json` | Output as JSON |


### sinch numbers active get

Get details for a specific active number.


```sh
sinch numbers active get [phone-number]
```

### sinch numbers active update

Update configuration for an active number (display name, SMS service plan, voice app, or callback URL).


```sh
sinch numbers active update [phone-number] [options]
```

| Option | Description |
|  --- | --- |
| `-d, --display-name <name>` | New display name |
| `--sms-service-plan <id>` | SMS service plan ID (empty string to unlink) |
| `--voice-app <id>` | Voice app ID |
| `--callback-url <url>` | Callback URL for provisioning events |


### sinch numbers active release

Release an active number, cancelling your subscription. Requires confirmation.


```sh
sinch numbers active release [phone-number] [-f, --force]
```

## sinch numbers available

Search for available phone numbers that you can rent.


```sh
sinch numbers available [options]
```

| Option | Description |
|  --- | --- |
| `-r, --region <code>` | Region code (e.g., `US`, `GB`) |
| `-t, --type <type>` | Number type: `MOBILE`, `LOCAL`, `TOLL_FREE` |
| `-c, --capability <cap...>` | Capability: `SMS`, `VOICE` |
| `-p, --pattern <digits>` | Digit pattern to search |
| `-l, --limit <number>` | Maximum results |
| `--rent` | Interactively choose and rent a number from results |


## sinch numbers regions

List regions where phone numbers are available.


```sh
sinch numbers regions [options]
```

| Option | Description |
|  --- | --- |
| `-t, --type <type>` | Filter by number type |
| `-c, --capability <cap>` | Filter by capability |