Skip to main content

​
Phone Numbers

Orbit provides virtual phone numbers in 60+ countries for SMS, voice, and multi-channel messaging. Search available numbers, purchase instantly, and configure routing — all through the API or dashboard.

​
Search Available Numbers

curl "https://orbit-api.devotel.io/api/v1/numbers/available?country=US&type=local&capabilities=sms,voice" \
  -H "X-API-Key: dv_live_sk_..."

​
Response

{
  "data": [
    {
      "number": "+14155550100",
      "country": "US",
      "type": "local",
      "capabilities": ["sms", "voice"],
      "monthly_cost": "1.50",
      "currency": "USD"
    },
    {
      "number": "+14155550101",
      "country": "US",
      "type": "local",
      "capabilities": ["sms", "voice"],
      "monthly_cost": "1.50",
      "currency": "USD"
    }
  ]
}

​
Purchase a Number

curl -X POST https://orbit-api.devotel.io/api/v1/numbers \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "number": "+14155550100",
    "friendly_name": "Main Support Line"
  }'

​
Configure Routing

Assign a number to receive inbound messages or calls: 
curl -X PATCH https://orbit-api.devotel.io/api/v1/numbers/num_abc123 \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "sms_webhook_url": "https://yourapp.com/webhooks/sms",
    "voice_webhook_url": "https://yourapp.com/webhooks/voice",
    "agent_id": "agent_support_bot"
  }'

​
Number Types

TypeDescriptionAvailability
LocalGeographic number tied to a city or region60+ countries
Toll-FreeFree for callers, costs billed to youUS, CA, UK, AU
MobileMobile number for SMS and voice40+ countries
Short Code5-6 digit number for high-volume SMSUS, CA, UK

​
Number Capabilities

CapabilityDescription
smsSend and receive SMS
voiceMake and receive calls
mmsSend and receive MMS (images, media)
whatsappRegister as WhatsApp Business number

​
Number Porting

Bring your existing numbers to Orbit. Submit a porting request through the dashboard under Numbers > Port a Number, or via the API: 
curl -X POST https://orbit-api.devotel.io/api/v1/numbers/port \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "numbers": ["+14155551234"],
    "current_carrier": "Carrier Name",
    "authorization_name": "John Doe"
  }'
Porting typically takes 7–14 business days depending on the country and carrier.