Network operations staffed around the clock
Skyroute
EN · EnglishEN
Vertrieb kontaktierenRequest access
INBOUND NUMBERS / DID INVENTORY

Reserve an inbound number from listed inventory.

DIDs are inbound numbers that can be assigned to an account and later routed to a SIP line or IVR flow. The customer numbers endpoint separates available inventory from numbers already owned by your account. A reservation is a local account and wallet action; it does not provision a number with a carrier.

BEFORE RESERVING

Check the number, country and monthly charge.

GET /api/v1/numbers returns available and owned DIDs, including country and monthly recurring charge. Inventory and prices can change. Review the exact number and current charge inside your console before submitting; this page does not display or promise a live available number.

An active plan and enough wallet funds are required. POST /api/v1/numbers with a did_id reserves an available number and charges the first month. The resulting state is reserved; carrier provisioning remains pending. Do not publish the number to callers until assignment and routing are confirmed.

REAL API PATH

List before you request a reservation.

A Bearer key needs numbers:read to list DIDs and numbers:write to reserve one. The ID below is only a request shape; choose a current available ID returned for your account.

GET /api/v1/numbers
GET /api/v1/numbers
Authorization: Bearer YOUR_API_KEY

POST /api/v1/numbers
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{"did_id":123}

Plan routing and compliance after assignment.

When carrier provisioning and assignment are complete, route the number to an approved endpoint or an IVR flow. Confirm local number eligibility, permitted use, caller notices and any recording rules for the destination. Inbound coverage is determined by actual carrier setup, not by a draft flow or local reservation.

Ask about number availability