CDR Field Mappings


Overview

The OneCloud API v2 uses descriptive field names for Call Detail Records (CDRs). This reference maps v2 field names to their v1 equivalents for developers migrating from v1 or working with both versions.

Note: Many fields may return null depending on call type or configuration.

Call Timing and Duration

v2 Fieldv1 FieldDescription
call-start-datetimetime_startWhen the SIP INVITE was initiated
call-answer-datetimetime-answerSIP 200 OK response time
call-ringing-datetimetime_ringingSIP 180/183 response time
call-disconnect-datetimetime_releaseSIP BYE transmission time
call-total-duration-secondsdurationComplete call length including hold and ring time
call-talking-duration-secondstime_talkingActive conversation time only
call-on-hold-duration-secondstime_holdingTime spent on hold

Call Direction and Status

v2 Fieldv1 FieldDescription
call-directiontypeOutbound, Inbound, or Missed
call-disconnect-reason-textrelease_textDisconnection reason description

Origination Details

v2 Fieldv1 FieldDescription
call-orig-userorig_subExtension number that initiated the call
call-orig-caller-idorig_idCaller ID for the originating party
call-orig-domainorig_domainOriginating user's domain
call-orig-ip-addressorig_ipSource IP address

Termination Details

v2 Fieldv1 FieldDescription
call-term-userterm_subReceiving extension number
call-term-caller-idterm_idTerminating party's caller ID
call-term-domainterm_domainRecipient's domain
call-term-ip-addressterm_ipDestination IP address

Media Codec Information

v2 Fieldv1 FieldDescription
call-audio-codeccodecNegotiated audio codec from SDP
call-video-codecvideo_codecNegotiated video codec from SDP
call-fax-codecimage_codecNegotiated fax codec from SDP

Note: Video and fax codecs may show generic names (Video, Image) in older releases.

Call Routing and Matching

v2 Fieldv1 FieldDescription
call-routing-match-uriroute_toPattern matched in the call routing table
call-orig-match-uriorig_matchOrigination pattern match
call-term-match-uriterm_matchTermination pattern match

Call Disposition (Agent Features)

v2 Fieldv1 FieldDescription
call-dispositiondispositionAgent-submitted disposition category
call-disposition-reasonreasonReason for the disposition
call-disposition-notesnotesAgent-entered notes
call-disposition-submitted-datetimetime_dispWhen the agent submitted the disposition

Batch Call Processing

v2 Fieldv1 FieldDescription
call-batch-start-datetimebatch_tim_begBatch initiation time
call-batch-answer-datetimebatch_tim_ansWhen any leg answered
call-batch-total-duration-secondsbatch_duraAccumulated duration across legs
call-leg-ordinal-indexcdr_indexCall leg sequence number
call-batch-sequence-markerrelease_codebegin, continue, or end

Call Intelligence

v2 FieldDescription
call-intelligence-job-idTranscription and sentiment tracking ID
call-intelligence-percent-negativeNegative sentiment percentage
call-intelligence-percent-neutralNeutral sentiment percentage
call-intelligence-percent-positivePositive sentiment percentage
call-intelligence-topics-topComma-separated discussion topics

System Metadata

v2 Fieldv1 FieldDescription
call-parent-cdr-idcdr_idUnique CDR identifier
call-parent-call-idservedCallIdOriginal call flow ID
call-record-creation-datetimetime_insertDatabase insertion time
core-serverhostnameFQDN of the processing server
domainCall leg's domain
resellerReseller territory designation
hide-from-resultshideWhether to exclude from user call history
is-trace-expectedWhether a SIP ladder diagram is available

Intermediary Call Processing

These fields track intermediaries involved in complex call flows (transfers, queues, etc.):

v2 Fieldv1 FieldDescription
call-through-actionby_actionSystem event type
call-through-userby_subIntermediary user account
call-through-caller-idby_idIntermediary caller ID
call-through-departmentby_groupIntermediary department
call-through-domainby_domainIntermediary domain

Key Notes

  • Fields reflect SIP header values after initial dial translations but before call routing (for "from" fields).
  • Account codes default to null unless configured.
  • Department, site, and reseller information may be null for SIP trunk calls.