Read vCon for CDR

GET

/domains/{domain}/cdrs/{cdr_id}/vcon

Last modified:2026-10-07 23:45:45

OperationId:ReadCdrVcon

Returns one vCon document for a call in a domain, addressed under its CDR. It is the same read as GET /domains/{domain}/vcon/{cdr_id}. Requires Office Manager, Site Manager, Reseller, Super User, or Super User Read Only scope: the same rights as reading the domain's CDRs. A Site Manager reads a call only when a user of its own site is a party on a leg in the path domain; any other call returns 404, as a CDR that does not exist does.

The document follows the IETF vCon core format. It joins every CDR leg of the call, including transfers and queue hops linked by call ID, with the recordings, transcript segments, sentiment, AI summary, and the internal parties' user profiles. Times are RFC 3339 in UTC with a Z suffix. Below Super User and Super User Read Only, a party from another domain carries only what your own CDR names: its SIP URI, extension, and user ID, with no user profile.

CDRs are stored by month. Send yyyymm when you know the month of the call. Without it, the API searches back from the current month, 12 months by default, and uses the first month that holds the CDR.

Each recording entry in dialog carries a signed url you can play without a token, through GET /recordings/play.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Query Params

Responses

🟢200OK

application/json

The vCon document.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains/example.com/cdrs/018f7a2c4e898b3a9c1d3a4f7e8b9c2d/vcon?yyyymm=202609' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Answered call with transcript

{
    "uuid": "6f1c2b3a-4d5e-5f60-8a71-b2c3d4e5f607",
    "created_at": "2026-09-01T14:30:00Z",
    "updated_at": "2026-09-01T14:34:05Z",
    "subject": "The caller asked about a delayed order and the agent confirmed the ship date.",
    "extensions": [
        "CC",
        "x-netsapiens"
    ],
    "parties": [
        {
            "role": "customer",
            "tel": "+15555550100",
            "sip": "sip:15555550100@203.0.113.30",
            "x-netsapiens": {
                "ip": "203.0.113.30"
            }
        },
        {
            "role": "agent",
            "sip": "sip:1001@example.com",
            "name": "Front Desk",
            "mailto": "user1001@example.com",
            "x-netsapiens": {
                "extension": "1001",
                "user_id": "1001@example.com",
                "site": "Main Office",
                "ip": "192.0.2.10"
            }
        }
    ],
    "dialog": [
        {
            "type": "recording",
            "start": "2026-09-01T14:30:04Z",
            "duration": 241.0,
            "parties": [
                0,
                1
            ],
            "mediatype": "audio/wav",
            "filename": "20260901143000012345-1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d.wav",
            "url": "https://core1.example.com/ns-api/v2/recordings/play?accel=recording1.example.com&casid=1001&cccid=7781&calid=20260901143000012345-1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d&uid=core1.example.com&time=20260901143000&auth=5d41402abc4b2a76b9719d911017c592",
            "content_hash": "sha512-q2Qe0bm8yU4h0zUwpbQ1oZ7m9aVbV3Jq0x1mN9b2y5c",
            "x-netsapiens": {
                "recording_status": "converted"
            }
        }
    ],
    "analysis": [
        {
            "type": "transcript",
            "dialog": [
                0
            ],
            "mediatype": "application/json",
            "vendor": "deepgram",
            "body": {
                "diarized": true,
                "segments": [
                    {
                        "party": 1,
                        "text": "Thanks for calling, how can I help you?",
                        "start": 1.04,
                        "end": 4.5,
                        "sentiment": "Positive",
                        "order": 1
                    },
                    {
                        "party": 0,
                        "text": "I am calling about an order that has not arrived.",
                        "start": 5.12,
                        "end": 9.8,
                        "sentiment": "Neutral",
                        "order": 2
                    }
                ]
            },
            "encoding": "json"
        },
        {
            "type": "summary",
            "dialog": [
                0
            ],
            "mediatype": "text/plain",
            "body": "The caller asked about a delayed order and the agent confirmed the ship date.",
            "encoding": "none"
        },
        {
            "type": "sentiment",
            "dialog": [
                0
            ],
            "mediatype": "application/json",
            "body": {
                "overall_positive_percent": 9,
                "overall_neutral_percent": 91,
                "overall_negative_percent": 0,
                "ending_sentiment": 0
            },
            "encoding": "json"
        },
        {
            "type": "tags",
            "dialog": [
                0
            ],
            "mediatype": "application/json",
            "body": {
                "disposition": "Sales",
                "reason": "Order status"
            },
            "encoding": "json"
        }
    ],
    "attachments": [
        {
            "type": "cdr",
            "mediatype": "application/json",
            "dialog": 0,
            "body": {
                "id": "018f7a2c4e898b3a9c1d3a4f7e8b9c2d",
                "cdr_index": 0,
                "orig_callid": "20260901143001054321-6d5c4b3a2f1e0d9c8b7a6f5e4d3c2b1a",
                "term_callid": "20260901143000012345-1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d",
                "orig_from_user": "15555550100",
                "orig_domain": "example.com",
                "term_sub": "1001",
                "term_domain": "example.com",
                "time_start": 1788273000,
                "time_answer": 1788273004,
                "time_release": 1788273245
            },
            "encoding": "json"
        }
    ],
    "x-netsapiens": {
        "generator": "netsapiens-api-v2",
        "domain": "example.com",
        "tenant": "example.com",
        "territory": "example-reseller"
    }
}

Modified at 2026-10-07 23:45:45

Download domain brand asset

Read vCon for call