POST
/
v1
/
geospatial-dialing-pools
curl -X POST "https://us.api.bland.ai/v1/geospatial-dialing-pools" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_numbers": ["+12345678901", "+19876543210", "+15551234567"],
    "encrypted_key": "550e8400-e29b-41d4-a716-446655440000"
  }'
{
  "status": "success",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440001",
    "owner_id": "550e8400-e29b-41d4-a716-446655440002",
    "phone_numbers": ["+12345678901", "+19876543210", "+15551234567"],
    "encrypted_key": "550e8400-e29b-41d4-a716-446655440000",
    "created_at": "2024-01-15T10:30:00Z"
  },
  "errors": null
}

Enterprise Feature - Geospatial dialing is only available on Enterprise plans. Contact your Bland representative for access.

Geospatial dialing pools allow you to create collections of phone numbers that will be automatically selected based on geographic proximity to optimize call pickup rates.

Headers

authorization
string
required

Your API key for authentication.

Body

phone_numbers
array
required

Array of phone numbers to include in the pool. All numbers must be valid US phone numbers with +1 prefix.

Format: Each phone number must be exactly 12 characters: +1 followed by 10 digits.

Example: ["+12345678901", "+19876543210"]

encrypted_key
string

Optional UUID of Twilio credentials to associate with this pool. If provided, must be valid credentials that belong to your account.

Format: UUID format (e.g., 550e8400-e29b-41d4-a716-446655440000)

Response

status
string

Can be success or error.

data
object

The created geospatial dialing pool object (present only if status is success).

errors
array

Array of error objects (present only if status is error).

curl -X POST "https://us.api.bland.ai/v1/geospatial-dialing-pools" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_numbers": ["+12345678901", "+19876543210", "+15551234567"],
    "encrypted_key": "550e8400-e29b-41d4-a716-446655440000"
  }'
{
  "status": "success",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440001",
    "owner_id": "550e8400-e29b-41d4-a716-446655440002",
    "phone_numbers": ["+12345678901", "+19876543210", "+15551234567"],
    "encrypted_key": "550e8400-e29b-41d4-a716-446655440000",
    "created_at": "2024-01-15T10:30:00Z"
  },
  "errors": null
}

Usage with Calls

Once you’ve created a geospatial dialing pool, you can use it in your call requests by specifying the geospatial_dialing parameter:

{
  "phone_number": "+12345678901",
  "task": "Your call task here",
  "geospatial_dialing": "550e8400-e29b-41d4-a716-446655440001"
}

The system will automatically select the most geographically appropriate phone number from your pool to maximize pickup rates.