Get DNI Snippets

Returns ready-to-paste DNI snippets for one or more org units.

Use Case
This endpoint allows an agency admin running many client websites to retrieve DNI snippets programmatically, so an AI assistant can provide the code and placement instructions without the customer opening the portal or reading documentation.

Access Control

Requires valid JWT authentication

Returns snippets only for org units within the user's authorized scope

Org units without access return an ACCESS_DENIED error in the errors array

DNI Configuration Requirement

Each org unit must have DNI enabled (dni_org_unit entry must exist)

Org units without DNI configured return a DNI_NOT_CONFIGURED error in the errors array

Response Structure

snippets — Object keyed by org_unit_id containing successful retrievals

errors — Array of errors for org units that failed (DNI not configured, not found, or access denied)

Snippet Content

Ready-to-paste <head> snippet for click-ID capture

Matches the existing CAI portal "Copy code" dialog exactly

Includes DNI settings, placement guidance, and verification steps

Placement Guidance

Primary: Website page <head>

Alternative: Google Tag Manager

Verification Steps

Load the website in a browser

Refresh the page

Confirm the tracking number changes or displays correctly

Place a test call to the displayed number

Confirm the call appears in Convirza reporting within a few minutes

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

{ "code": 200, "message": "success", "request_id": "550e8400-e29b-41d4-a716-446655440000", "timestamp": "2026-09-30T10:30:00.000Z", "data": { "snippets": { "70035": { "org_unit_id": 70035, "org_unit_name": "My Business Group", "snippet": "<script defer src=\"https://dni.convirza.com/dni.js?app_id=CT\"></script>\n<script type=\"text/javascript\">\n function dniLoadingTimer() { \n if (typeof(getDNIRecord) == \"function\") {\n getDNIRecord(\"a1b2c3d4e5f6\", \"dni.convirza.com\");\n } else {\n setTimeout(dniLoadingTimer, 100); \n } \n }\n setTimeout(dniLoadingTimer, 100); \n</script>", "settings": { "identifier": "PHONE_NUMBER", "number_format": "(xxx) xxx-xxxx", "keep_alive_mins": 30, "element_based": { "dni_element": ".phone-number", "dni_type": "source" }, "url_based": null }, "placement": { "primary": "head", "alternative": "google_tag_manager" }, "verification_steps": [ "Load your website in a browser", "Refresh the page", "Confirm the tracking number changes or displays correctly", "Place a test call to the displayed number", "Confirm the call appears in Convirza reporting within a few minutes" ] } }, "errors": [ { "org_unit_id": 70037, "error_code": "DNI_NOT_CONFIGURED", "error_message": "DNI is not configured for this org unit. Enable DNI in the portal first." } ] } }

Get DNI Snippets

Request

Responses