sinch-number-lookup-apilisted
Install: claude install-skill sinch/skills
# Sinch Number Lookup API
## Overview
Queries phone numbers for carrier, line type, porting, SIM swap, VoIP detection, and reassigned number detection. Used for fraud prevention, routing, and data enrichment. One number per request — no batch endpoint.
## Agent Instructions
Before generating code, gather from the user: **approach** (SDK or direct API calls) and **language** (Node.js, Python, Java, .NET/C#, curl). Do not assume defaults.
When the user chooses **SDK**, refer to [sinch-sdks](../sinch-sdks/SKILL.md) for installation, client initialization, and language-specific references. Note: Number Lookup is only supported in **Node.js** and **Python** (partial) SDKs — for Java and .NET, use direct HTTP calls.
## Getting Started
### Agent Credentials handling
Store credentials in environment variables — never hardcode tokens or keys in commands or source code:
```bash
export SINCH_PROJECT_ID="your-project-id"
export SINCH_KEY_ID="your-key-id"
export SINCH_KEY_SECRET="your-key-secret"
export SINCH_ACCESS_TOKEN="your-oauth-token"
```
### Authentication
Ensure that authentication headers are properly set when making API calls. The Number Lookup API uses Bearer token authentication:
```bash
-H "Authorization: Bearer $SINCH_ACCESS_TOKEN"
```
See [sinch-authentication](../sinch-authentication/SKILL.md) for full setup, most importantly how to obtain `{SINCH_ACCESS_TOKEN}` (OAuth2 client-credentials — do not mint your own JWT).
### Base URL
`https://lookup.api.sinch.co