skills.rest
sinch
sinchOFFICIAL
Explore all skills by this author →
WebsiteGitHub

sinch-api-numbers-search

Search available phone numbers to rent via the Sinch Numbers API.

6|2|Updated Dec 11, 2025
Search Tags:#search#telephony#sms#oauth2#phone numbers#sinch#numbers api
One-click install
npx skills add https://github.com/sinch/sinch-plugins --skill sinch-api-numbers-search-sinch
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sinch-api-numbers-search
Source: https://github.com/sinch/sinch-plugins/tree/main/plugins/sinch-antigravity-plugin/skills/sinch-api-numbers-search
Command: npx skills add https://github.com/sinch/sinch-plugins --skill sinch-api-numbers-search-sinch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding rentable phone numbers for SMS or voice applications requires manual dashboard browsing or custom API scripting. This Skill queries the Sinch Numbers API directly to list available numbers by region, type, and capability. ## Core Features & Use Cases - Available Number Search: Query available phone numbers by region code (e.g., US, GB), number type (LOCAL, MOBILE, TOLL_FREE), and capability (SMS, VOICE). - Flexible Output: Display results as a formatted table or raw JSON with configurable page size. - OAuth2 Authentication: Uses Sinch credentials from environment variables to authenticate against the Numbers API. - Use Case: A developer building an SMS notification service needs a US local number with SMS capability; run the search to list rentable numbers before provisioning. ## Quick Start Ask the assistant to search for available US local phone numbers with SMS capability using the Sinch Numbers API.

Frequently Asked Questions about sinch-api-numbers-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for available phone numbers with the Sinch Numbers API?▼

Provide a region code such as US or GB, and optionally filter by number type (LOCAL, MOBILE, TOLL_FREE) and capability (SMS, VOICE). The Skill calls the availableNumbers endpoint and returns matching rentable numbers in a table or JSON.

What credentials does the Sinch Numbers API search require?▼

It requires Sinch project credentials set as environment variables, either CONVERSATION_* or NUMBERS_* variables including the project ID. Authentication uses OAuth2 against https://numbers.api.sinch.com/v1.

Can I filter Sinch phone numbers by SMS and voice capability?▼

Yes, pass the capability parameter with SMS, VOICE, or both as a comma-separated value. The search returns only numbers supporting the requested capabilities in the specified region.

Why does the Sinch number search return a 401 error?▼

A 401 response indicates missing or invalid OAuth2 credentials. Verify that the project ID, key ID, and key secret environment variables are set correctly and that the access key is active in the Sinch dashboard.

What output formats does the number search support?▼

Results can be displayed as a formatted table showing number, type, region, and capabilities, or as raw JSON. The page size parameter controls how many results are returned per request, defaulting to 10.

Related Skills

Explore More Software Engineering Skills→
sinchsinch
9

sinch-authentication

Configure Sinch API credentials and authentication across services.

Official
Intermediate
sinchsinch
9

sinch-numbers-api

Search, rent, and configure Sinch numbers via the Numbers API.

Official
Intermediate
awesome-skillsawesome-skills
1.9k

code-review-skill

Reviews pull requests across 20+ languages using structured four-phase analysis and severity-labeled feedback.

Official
Advanced
refactory-langrefactory-lang

speckit-workflows.hotfix

Automate emergency hotfix workflows with mandatory post-mortem documentation.

Official
Advanced