Geo Fencing - Telephony

Geo‑fencing allows you to restrict inbound and outbound calls based on the caller’s geographic location. It ensures that SIP traffic is routed only through approved geographic regions, helping maintain compliance, security, and regional telephony rules.

Users connect to a specific regional VideoSDK server based on the geoRegion value they set. In this example, even though some users are located in India, a user who sets geoRegion to ‘US’ is routed through the US server, and all users are then bridged together inside the same VideoSDK room.

Inbound Calls

For inbound calls, Geo-fencing lets you choose which regional SIP server should handle the call. This can be configured using the SIP URI or through the VideoSDK Dashboard.

Via SIP URI

You can specify the region directly in the SIP Inbound Gateway URI:

sip:$YOUR_ORG_ID.<region>.sip.videosdk.live

Replace $YOUR_ORG_ID with your actual VideoSDK organization ID and <region> with one of the supported region codes.

Available region codes:

• in001 → India
• us002 → United States

Via Dashboard

Configure the geo region in the VideoSDK dashboard.

Outbound Calls

When making outbound calls, you can control the SIP server region via the Dashboard or the API Request.

Via API

You can control the SIP server region via the geoRegion property in the API request. If geoRegion is omitted, Video SDK selects the region automatically based on the dialed number’s location.

curl --request POST \
  --url https://api.videosdk.live/v2/sip/outbound-gateways \
  --header 'Authorization: YOUR_VIDEOSDK_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "My Outbound Gateway",
    "numbers": ["+1234567890"],
    "address": "sip.provider.com",
    "geoRegion" : "us002",
    "auth": {
      "username": "sip_username",
      "password": "sip_password"
    }
  }'

Via Dashboard

Set the desired region in the VideoSDK dashboard.