# Sinch API Numbers Search

> Search available phone numbers to rent via Sinch Numbers API

- Skill: `sinch/sinch-api-numbers-search` (Agent Skill)
- Install (CLI): `npx skillmds@latest add sinch/sinch-api-numbers-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sinch/sinch-api-numbers-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: sinch (https://skillmd.com/u/sinch)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/sinch/sinch-api-numbers-search

---


# Search Available Numbers

Search for available phone numbers to rent from the Sinch Numbers API (by region, type, capability). Uses OAuth2.

**IMPORTANT: Execute this command directly. Do NOT generate script files. Perform the API call immediately.**

## Input

- `--region` / `-r`: Region code (e.g. US, GB) - required
- `--type` / `-t`: Number type: LOCAL, MOBILE, TOLL_FREE - optional
- `--capability` / `-c`: Capability: SMS, VOICE (comma-separated for multiple) - optional
- `--page-size` / `-n`: Results per page - optional, default 10
- `--format` / `-f`: Output format (table or json) - optional

Arguments: $ARGUMENTS

## Instructions

**Execute these steps directly - do not write code or scripts:**

0. If $ARGUMENTS empty: ask for region, optional type and capability. Otherwise parse.

1. Validate: --region (e.g. US, GB), optional type, capability, page-size. Get CONVERSATION_* or NUMBERS_* env vars. Numbers API: https://numbers.api.sinch.com/v1. If missing, report "Sinch API is not configured."

2. GET https://numbers.api.sinch.com/v1/projects/{projectId}/availableNumbers or equivalent with query params: regionCode, type, capabilities, pageSize. Use OAuth2.

3. Format response: table (number, type, region, capabilities) or JSON. Display "✅ Available numbers" with count. Handle 401, 404.

4. Handle all errors gracefully.

## Examples

```
/sinch-api-numbers-search --region=US --type=LOCAL --capability=SMS
/sinch-api-numbers-search -r US -c SMS,VOICE -n 20
```

## API Reference

- **Base URL**: https://numbers.api.sinch.com/v1
- **Active numbers**: GET /projects/{projectId}/activeNumbers
- **Available numbers**: Check Numbers API docs for search/available endpoint
- **Documentation**: https://developers.sinch.com/docs/numbers/