sinch-numbers-apilisted
Install: claude install-skill sinch/skills
# Sinch Numbers API
The Numbers API lets you search, activate, manage, and release phone numbers — the prerequisite for SMS, Voice, and Conversation APIs.
## Instructions
### Step 1: Choose approach
- **SDK project?** Default to SDK if `@sinch/sdk-core` (Node), `sinch` (Python), or `com.sinch.sdk` (Java) is present.
- **Direct HTTP?** Use curl/fetch with Basic auth.
For SDK code, read the correct reference before generating any code:
| Language | Reference | SDK docs |
|----------|-----------|----------|
| TypeScript/Node.js | [references/typescript.md](references/typescript.md) | [Syntax reference](https://developers.sinch.com/docs/numbers/sdk/node/syntax-reference) |
| Python | [references/python.md](references/python.md) | [Syntax reference](https://developers.sinch.com/docs/numbers/sdk/py/syntax-reference) |
| Java | [references/java.md](references/java.md) | [Syntax reference](https://developers.sinch.com/docs/numbers/sdk/java/syntax-reference) |
For direct HTTP calls, see [Numbers API Reference](https://developers.sinch.com/docs/numbers/api-reference/numbers.md).
### Step 2: Authenticate
See [sinch-authentication](../sinch-authentication/SKILL.md) for full setup.
### Step 3: Verify connectivity
```bash
curl -X GET \
"https://numbers.api.sinch.com/v1/projects/$SINCH_PROJECT_ID/activeNumbers?regionCode=US&type=LOCAL&pageSize=10" \
-H "Authorization: Bearer $SINCH_ACCESS_TOKEN" \
-H "Content-Type: application/json"
```
A 200 response confirms credentials