Skip to main content

Documentation Index

Fetch the complete documentation index at: https://orbit-docs.devotel.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Number Masking (Proxy) API

Connect Party A to Party B via a third “proxy” number — both sides dial / SMS the proxy and the platform forwards. Used by marketplaces and ride-share apps where the buyer and seller shouldn’t see each other’s real phone number. Base path: /api/v1/proxy Authentication: API key (X-API-Key) or session JWT.

​
Sessions

A session is the active mapping. While the session is open, calls and SMS to the proxy number from Party A are forwarded to Party B and vice versa.
MethodPathPurpose
POST/v1/proxy/sessionsCreate a session (book a proxy number)
GET/v1/proxy/sessionsList active sessions
GET/v1/proxy/sessions/{id}Get a session
DELETE/v1/proxy/sessions/{id}Close a session

​
Inbound webhook

Carrier inbound traffic to the proxy number is posted to POST /api/v1/proxy/inbound — platform-managed. You don’t call this directly.

​
Example — book a proxy session for an Uber-style ride

curl -X POST https://api.orbit.devotel.io/api/v1/proxy/sessions \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "party_a": "+14155551111",
    "party_b": "+14155552222",
    "expires_at": "2026-05-09T12:00:00Z",
    "channels": ["voice", "sms"]
  }'
The response includes the proxy number both parties should call/text. Close the session with DELETE when the trip ends.