# `smallforce calls phone-numbers`

Search, purchase and manage inbound phone numbers

This page is generated from the same Commander definition shipped in SmallForce CLI 0.1.8. Run `smallforce calls phone-numbers --help` locally to view the same reference for your installed version.

## Subcommands

- [`smallforce calls phone-numbers search`](/docs/cli/commands/calls/phone-numbers/search): Search available phone numbers
- [`smallforce calls phone-numbers list`](/docs/cli/commands/calls/phone-numbers/list): List purchased phone numbers and their billing status
- [`smallforce calls phone-numbers buy`](/docs/cli/commands/calls/phone-numbers/buy): Purchase a phone number; the service checks and charges credits
- [`smallforce calls phone-numbers get`](/docs/cli/commands/calls/phone-numbers/get): Get a purchased phone number
- [`smallforce calls phone-numbers attach`](/docs/cli/commands/calls/phone-numbers/attach): Attach a purchased number to a voice assistant
- [`smallforce calls phone-numbers detach`](/docs/cli/commands/calls/phone-numbers/detach): Detach a number from its assistant; keep the purchased number
- [`smallforce calls phone-numbers sync-webhooks`](/docs/cli/commands/calls/phone-numbers/sync-webhooks): Sync the service's current voice webhooks to the provider
- [`smallforce calls phone-numbers delete`](/docs/cli/commands/calls/phone-numbers/delete): Release the number with the provider and mark it deleted

## Complete command help

```text
Usage: smallforce calls phone-numbers [options] [command]

Search, purchase and manage inbound phone numbers

Options:
  --api-key <key>                          SmallForce API key, or set SMALLFORCE_API_KEY
  --backend-url <url>                      SmallForce backend URL, or set SMALLFORCE_BACKEND_URL
  --json                                   Print stable machine-readable JSON
  --text                                   Print human-readable text
  --format <format>                        Output format: text or json
  -h, --help                               display help for command

Commands:
  search [options]                         Search available phone numbers
  list [options]                           List purchased phone numbers and their billing status
  buy [options]                            Purchase a phone number; the service checks and charges
                                           credits
  get [options] <phoneNumberId>            Get a purchased phone number
  attach [options] <phoneNumberId>         Attach a purchased number to a voice assistant
  detach [options] <phoneNumberId>         Detach a number from its assistant; keep the purchased
                                           number
  sync-webhooks [options] <phoneNumberId>  Sync the service's current voice webhooks to the provider
  delete [options] <phoneNumberId>         Release the number with the provider and mark it deleted
  help [command]                           display help for command
```

## Related reference

- [`smallforce calls`](/docs/cli/commands/calls): Parent command and related operations.
- [CLI installation and authentication](/docs/cli/getting-started): Install the CLI and configure an API key.
- [CLI JSON output](/docs/cli/json-output): Use stable machine-readable output in scripts and agents.