Skip to content

sinch numbers

Manage Sinch phone numbers: search available numbers, view active numbers, update configuration, and release numbers. See Sinch Numbers API 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.

sinch numbers active list [options]
OptionDescription
-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
--jsonOutput as JSON

sinch numbers active get

Get details for a specific active number.

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).

sinch numbers active update [phone-number] [options]
OptionDescription
-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.

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

sinch numbers available

Search for available phone numbers that you can rent.

sinch numbers available [options]
OptionDescription
-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
--rentInteractively choose and rent a number from results

sinch numbers regions

List regions where phone numbers are available.

sinch numbers regions [options]
OptionDescription
-t, --type <type>Filter by number type
-c, --capability <cap>Filter by capability