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

sinch-api-numbers-lookup

Look up phone number carrier, line type, and porting details via the Sinch Number Lookup API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Verifying phone numbers before sending messages or onboarding users requires manual checks against carrier databases. This Skill queries the Sinch Number Lookup API directly to return carrier, line type, porting status, and VoIP probability for one or more E.164 numbers. ## Core Features & Use Cases - Bulk Number Lookup: Look up one or multiple comma-separated E.164 phone numbers in a single API call. - Flexible Output: Display results as a readable table or as raw JSON for downstream processing. - OAuth2 Authentication: Uses Sinch project credentials (Project ID, Key ID, Key Secret) to obtain a Bearer token for the Lookup API. - Use Case: Before launching an SMS campaign, look up your recipient list to filter out landline or VoIP numbers that cannot receive text messages. ## Quick Start Ask the assistant to look up the carrier and line type for the phone number +14155551234 using the Sinch Number Lookup API.

Frequently Asked Questions about sinch-api-numbers-lookup

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

FAQPage Schema
How do I look up phone number carrier and line type with Sinch?▼

Provide one or more E.164 formatted numbers and the Skill sends a POST request to the Sinch Number Lookup API at lookup.api.sinch.com/v2. Results include carrier, line type, porting status, and VoIP probability in table or JSON format.

What credentials does the Sinch Number Lookup API require?▼

It requires CONVERSATION_PROJECT_ID, CONVERSATION_KEY_ID, and CONVERSATION_KEY_SECRET environment variables from your Sinch dashboard. These are used to obtain an OAuth2 Bearer token for authenticating lookup requests.

Can I look up multiple phone numbers in one request?▼

Yes, pass multiple comma-separated E.164 numbers with the --numbers flag. The Skill sends them as an array in a single POST body to the /projects/{projectId}/lookups endpoint.

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

A 401 error means the OAuth2 token request failed, usually due to missing or incorrect Key ID or Key Secret environment variables. Verify your credentials in the Sinch Customer Dashboard and ensure all three variables are set.

What phone number format does the lookup API accept?▼

The API requires E.164 format, which is a plus sign followed by country code and number with no spaces or dashes, such as +14155551234. Numbers in other formats must be normalized before lookup.

Related Skills

Explore More Software Engineering Skills→
filimorniga-uxfilimorniga-ux

input-behavior-chile

Format RUT, CLP currency, and +56 phone numbers in React/Next.js forms.

Community
Intermediate
p-sree-sai-pavanp-sree-sai-pavan
5

imsg

Read and send iMessages or SMS via macOS Messages.app from the command line.

Community
Advanced
orthogonal-shorthogonal-sh
12

send-text-message

Send SMS text messages via the Textbelt API with delivery status checks.

Official
Intermediate
MoonAxisMoonAxis

preset

Deploy Azure OpenAI models to regions with available capacity.

Official
Advanced