sinch-number-order-api

Order KYC-compliant phone numbers via the Sinch Numbers API.

9|4|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/sinch/skills --skill sinch-number-order-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sinch-number-order-api
Source: https://github.com/sinch/skills/tree/main/skills/sinch-number-order-api
Command: npx skills add https://github.com/sinch/skills --skill sinch-number-order-api

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guides users through the fragile, multi-step process of purchasing and registering phone numbers in countries that require KYC and regulatory compliance, removing guesswork and preventing order expiration or rejection.

Core Features & Use Cases

  • Sequential Workflow Enforcement: Step-by-step guidance for lookup, search, order creation, registration submission, attachment uploads, and final submission to ensure the correct order of operations.
  • KYC Schema & Attachment Handling: Uses the lookup requirements response to populate validation fields and upload mandatory attachments with MIME/type checks.
  • Order Management & Recovery: Tracks idNumberOrder, expireTime, and order states, with recovery paths for validation errors, unavailable numbers, rejections, and expirations.
  • Use Case: Buy or provision a single phone number or bulk quantity in regulated regions while ensuring identity verification and timely submission to avoid expiry.

Quick Start

Use the sinch-number-order-api skill to perform a sequential KYC number order: lookup requirements, choose or search numbers, create the order, submit registration data, upload any mandatory attachments, and submit the order before it expires.

Frequently Asked Questions about sinch-number-order-api

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

FAQPage Schema
How do I order phone numbers in countries requiring KYC compliance?

To order phone numbers requiring KYC compliance, you must sequentially lookup regulatory requirements, search available numbers, create an order, submit registration data, upload mandatory attachments, and finalize the submission before the 48-hour expiry.

What is the process for submitting KYC registration data when provisioning a phone number?

KYC registration submission involves using the lookup requirements response to populate validation fields and uploading mandatory identity attachments with MIME/type checks before final order submission.

Can I bulk provision phone numbers with identity verification using the Sinch Numbers API?

Yes, you can provision single or bulk phone numbers in regulated regions by creating an order and ensuring identity verification data and attachments are submitted sequentially before expiration.

What authentication do I need to purchase phone numbers through the Sinch Numbers API?

You need to authenticate using either OAuth2 or Key ID and Key Secret to purchase phone numbers through the Sinch Numbers API.

Why do my Sinch number orders expire before completion?

Sinch number orders expire if not fully submitted within 48 hours, requiring you to track the idNumberOrder and expireTime to ensure registration data and attachments are uploaded promptly.

Does the Sinch Numbers API support E.164 formatted numbers for regulatory provisioning?

Yes, the Sinch Numbers API requires E.164 formatted numbers when searching for available numbers and executing KYC-compliant provisioning workflows.