Phone Numbers

Search, purchase, and manage virtual phone numbers through Orbit

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": "[phone]",
      "country": "US",
      "type": "local",
      "capabilities": ["sms", "voice"],
      "monthly_cost": "1.50",
      "currency": "USD"
    },
    {
      "number": "[phone]",
      "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": "[phone]",
    "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

Type	Description	Availability
Local	Geographic number tied to a city or region	60+ countries
Toll-Free	Free for callers, costs billed to you	US, CA, UK, AU
Mobile	Mobile number for SMS and voice	40+ countries
Short Code	5-6 digit number for high-volume SMS	US, CA, UK

Number Capabilities

Capability	Description
sms	Send and receive SMS
voice	Make and receive calls
mms	Send and receive MMS (images, media)
whatsapp	Register 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": ["[phone]"],
    "current_carrier": "Carrier Name",
    "authorization_name": "John Doe"
  }'

Porting typically takes 7–14 business days depending on the country and carrier.