Facebook
LinkedIn
YouTube
Getting Started
Authentication
Authentication
  • V2 Authentication (Deprecated)
  • V3 Authentication
V2 API Documentation (Deprecated)V3 API Documentation
Dialer SDK
Getting Started
Authentication
Authentication
  • V2 Authentication (Deprecated)
  • V3 Authentication
V2 API Documentation (Deprecated)V3 API Documentation
Dialer SDK
  1. Provisioned Routes
  • Platform
    • Users
      • List Users
      • Create User
      • Get User Details
      • Update User
      • Partial Update User
      • Delete User
    • Groups
      • Get Group Tree
      • List Child Groups
      • Get Group Details
      • List Groups
      • Get Org Unit Hierarchy
      • Update Group
      • Partial Update Group
      • Delete Group
      • Create Group
    • Webhooks
      • Create Webhook
      • Get Webhook Details
      • List Webhooks
      • Update Webhook
      • Partial Update Webhook
      • Delete Webhook
    • Media Prompts
      • List Prompts
      • Get Prompt by ID
      • Upload Prompt
      • Delete Prompt
  • AI Voice Agents
    • List AI Voice Agents
      GET
    • Get Agent Details
      GET
    • Delete Agent
      DELETE
  • Phone Numbers
    • Assigned Numbers
      GET
    • Provisioned Numbers
      GET
    • Reserved Numbers
      DELETE
    • Phone Numbers
      POST
    • Available Numbers
      GET
  • Provisioned Routes
    • List Provisioned Routes
      GET
    • Create Provisioned Route
      POST
    • Get Provisioned Route Details
      GET
    • Delete Provisioned Route
      DELETE
    • Update Provisioned Route
      PUT
    • Partial Update Provisioned Route
      PATCH
  • SMS Broadcasts
    • List Broadcasts
      GET
    • Create Broadcast
      POST
    • Get Broadcast Details
      GET
    • Update Broadcast
      PUT
    • Partial Update Broadcast
      PATCH
    • Delete Broadcast
      DELETE
  • Conversation
    • Calls
      • Get Calls List
      • Get Call By ID
      • Email Call Data
      • Move Call to Another Group
      • Add Notes to Calls
      • Upload Call Recording
      • Add Tags to Call
    • SMS
      • Get SMS Conversations
      • Get SMS Conversation By ID
    • Opportunity Recovery
      • Get Conversations By Custom Insights
    • Agent Performance
      • Get Agent Performance Metrics
    • Attribution Engine
      • Get Marketing Attribution Data
  • Blacklist
    • List blacklisted numbers
    • Add numbers to blacklist
    • Delete numbers from blacklist
  • Call Action Templates
    • Create Call Action Template
    • Update Call Action Template
  • Campaigns
    • List Campaigns
    • Create Campaign
    • Get Campaign Details
    • Update Campaign
    • Partial Update Campaign
    • Delete Campaign
  • Custom Insights
    • Get Custom Insights
    • Create New Custom Insight
    • Get Custom Insight By Id
    • Update Custom Insight
    • Partial Update Custom Insight
    • Delete Custom Insight
  • Custom Source
    • Get Custom Sources
    • Create Custom Source
    • Delete Custom Sources (Single or Multiple)
  • DNI
    • List DNI Settings
    • Update DNI Setting
    • Delete DNI Setting
    • Create DNI Setting
  • Geo Locations
    • List Geo Locations
    • Create Geo Location
    • Get Geo Location
    • Update Geo Location
    • Partially Update Geo Location
    • Delete Geo Location
    • List Geo Location Routes
    • Create Geo Location Route
    • Get Geo Location Route
    • Update Geo Location Route
    • Partially Update Geo Location Route
    • Delete Geo Location Route
    • Import Geo Location Routes from CSV
  • Insights
    • List Insights
    • Create Insight
    • Get Insight Details
    • Delete Insight
  • Scorecards
    • List Scorecards
    • Get Scored Calls Report
    • Create Scorecard
    • Add or Update Call Title
    • Duplicate Scorecard
    • Archive Scorecard
  • Miscellaneous
    • List Ad Sources
    • List Industries
    • List Tags
    • Create Tag
    • Update Tag
    • Delete Tag
  • Subscriptions
    • List Webhook Subscriptions
    • Create Webhook Subscription
    • Delete Webhook Subscription
  1. Provisioned Routes

Get Provisioned Route Details

GET
https://platform-api.convirza.com/v3/provisioned-routes/{provisioned_route_id}
Provisioned Routes
Last modified:2026-07-24 13:10:44
Retrieves the complete configuration for a single provisioned route by its unique identifier.
Response Includes
Route identity — name, status, organization unit
External identifiers — campaign_ext_id, org_unit_ext_id, ad_source_id for integration with external systems
Organization details — org_unit_id, org_unit_ext_id, org_unit_name (organization unit name)
Campaign association — campaign_id, campaign_ext_id, campaign_name (null if no campaign)
DNI settings — dni_data, dni_enabled (always included, empty arrays/false if no DNI configured)
Routing configuration — forwarding number, routing type (simple, ivr, georoute, percentage, outbound, voicemail, schedule, hangup), ring strategy
Call handling — voice prompt, whisper message, first-time-caller whisper, voicemail fallback
Advanced features — SMS forwarding, AI voice agent integration, ODN (Originally Dialed Number)
Overflow numbers and hunt group settings
All tracking phone numbers assigned to this route (including sms_feature per number)
Number pool details if the route uses a number pool (pool name, TTL, phone numbers)
Common Use Cases
Inspect or audit a specific route's settings before making changes
Export configuration for documentation or compliance
Troubleshoot unexpected call routing behavior
Integrate with external CRM or marketing platforms using external identifiers
Note: This endpoint always includes DNI data (unlike the list endpoint where it's optional via ?include=dni_data). Matches api2 /v1/cai/tndetail/:id format.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Responses

🟢200
application/json
Complete provisioned route configuration retrieved successfully
Bodyapplication/json

🟠401
🟠404
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff 'https://platform-api.convirza.com/v3/provisioned-routes/{provisioned_route_id}' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Example 1
{
    "code": 200,
    "message": "Success",
    "data": {
        "provisioned_route_id": "12345",
        "provisioned_route_name": "Spring Campaign - Organic",
        "provisioned_route_status": "active",
        "org_unit_id": 70035,
        "org_unit_ext_id": "ORG-12345",
        "org_unit_name": "Sales Department",
        "repeat_interval": 30,
        "conversion_value": 150,
        "campaign_id": 789,
        "campaign_name": "Spring 2026 Campaign",
        "campaign_ext_id": 456,
        "ad_source_id": 5,
        "routing_configuration": {
            "routing_type": "simple",
            "config": {
                "default_ringto": "2025551234",
                "activate_voice_prompt": true,
                "voice_prompt": "file",
                "activate_whisper_message": true,
                "whisper_message": "Inbound lead from Google Ads",
                "activate_voicemail": false,
                "voicemail_message": "Please leave your name and number after the tone."
            }
        },
        "sms_enabled": true,
        "phone_numbers": [
            {
                "phone_number": "4058737820",
                "number_id": "98765",
                "sms_feature": "enabled"
            }
        ],
        "dni_data": [
            {
                "dni_org_unit": [
                    {
                        "org_unit_id": 70035,
                        "custom_params": "utm_source={{source}}&utm_medium={{medium}}",
                        "dni_code": "dni_abc123"
                    }
                ],
                "dni_settings": [
                    {
                        "dni_setting_id": 123,
                        "dni_setting_name": "Homepage DNI - Google Ads",
                        "provisioned_route_id": 8790,
                        "org_unit_id": 70035,
                        "destination_url": "https://example.com/landing-page",
                        "dni_type": "static",
                        "referrer": "google.com",
                        "referrer_type": "contains",
                        "dni_element": "span#phone-number",
                        "dni_keywords": "google ads, ppc",
                        "dni_number_format": "(XXX) XXX-XXXX",
                        "identifier": "dni_code_abc123",
                        "number": "Sales Pool",
                        "dni_ttl": 30,
                        "pool_id": 456
                    }
                ]
            }
        ],
        "dni_enabled": true,
        "number_pool": {
            "pool_id": 456,
            "pool_name": "Sales Pool - March Campaign",
            "keep_alive_mins": 30,
            "number_count": 10,
            "status": "active",
            "phone_numbers": [
                {
                    "phone_number": "8001234567",
                    "number_id": "8001234567",
                    "number_type": "DID",
                    "vendor_id": 1,
                    "resporg_id": "RESPORG123"
                }
            ]
        }
    },
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-03-27T10:30:00.000Z"
}
Modified at 2026-07-24 13:10:44
Previous
Create Provisioned Route
Next
Delete Provisioned Route
Built with