Cisco Voice Portal Call Detail Records API
Access and query call detail records
Access and query call detail records
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/cisco-voice-portal-call-detail-records-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Cisco Voice Portal Reporting Call Detail Records API
description: The Cisco Unified Customer Voice Portal (CVP) Reporting API provides access to call detail records (CDRs), real-time call statistics, and historical reporting data. The Reporting Server collects data from CVP Call Servers and VXML Servers, storing it in the CVP Reporting Database (an Informix database). This API provides RESTful access to reporting data that is typically accessed via the Cisco Unified Intelligence Center (CUIC) reporting interface.
version: 12.6.0
contact:
name: Cisco Developer Support
url: https://developer.cisco.com/
license:
name: Cisco DevNet
url: https://developer.cisco.com/site/license/
x-provider: cisco
x-product: unified-customer-voice-portal
servers:
- url: https://{reporting-server}:8111/cvp-reporting/rest
description: CVP Reporting Server REST API
variables:
reporting-server:
default: cvp-reporting.example.com
description: Hostname or IP of the CVP Reporting Server
security:
- basicAuth: []
tags:
- name: Call Detail Records
description: Access and query call detail records
paths:
/cdr:
get:
operationId: getCallDetailRecords
summary: Cisco Voice Portal Query Call Detail Records
description: Retrieves call detail records (CDRs) based on specified filter criteria. CDRs contain comprehensive information about each call processed by CVP including timing, routing decisions, application interactions, and outcome.
tags:
- Call Detail Records
parameters:
- name: startTime
in: query
required: true
description: Start of the query time range (ISO 8601)
schema:
type: string
format: date-time
- name: endTime
in: query
required: true
description: End of the query time range (ISO 8601)
schema:
type: string
format: date-time
- name: calledNumber
in: query
description: Filter by called number (DNIS)
schema:
type: string
- name: callingNumber
in: query
description: Filter by calling number (ANI)
schema:
type: string
- name: callGuid
in: query
description: Filter by unique call GUID
schema:
type: string
- name: callResult
in: query
description: Filter by call result
schema:
type: string
enum:
- completed
- abandoned
- transferred
- error
- name: offset
in: query
description: Pagination offset
schema:
type: integer
default: 0
- name: limit
in: query
description: Maximum number of records to return
schema:
type: integer
default: 100
maximum: 1000
- name: sortBy
in: query
description: Field to sort by
schema:
type: string
default: callStartTime
enum:
- callStartTime
- callEndTime
- calledNumber
- callingNumber
- name: sortOrder
in: query
schema:
type: string
enum:
- asc
- desc
default: desc
responses:
'200':
description: Call detail records matching the query
content:
application/json:
schema:
$ref: '#/components/schemas/CdrQueryResult'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'500':
$ref: '#/components/responses/InternalError'
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/cdr/{callGuid}:
get:
operationId: getCallDetailRecord
summary: Cisco Voice Portal Get a Specific Call Detail Record
description: Retrieves the complete call detail record for a specific call, identified by its globally unique identifier (GUID). Includes all call legs, application interactions, and ECC variables.
tags:
- Call Detail Records
parameters:
- name: callGuid
in: path
required: true
description: Globally unique call identifier
schema:
type: string
responses:
'200':
description: Call detail record
content:
application/json:
schema:
$ref: '#/components/schemas/CallDetailRecord'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'500':
$ref: '#/components/responses/InternalError'
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/cdr/{callGuid}/legs:
get:
operationId: getCallLegs
summary: Cisco Voice Portal Get Call Legs for a Call
description: Retrieves all individual call legs associated with a specific call. A call may have multiple legs representing transfers, conferences, or application hand-offs within the CVP system.
tags:
- Call Detail Records
parameters:
- name: callGuid
in: path
required: true
schema:
type: string
responses:
'200':
description: Call legs
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/CallLeg'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'500':
$ref: '#/components/responses/InternalError'
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
components:
schemas:
CallDetailRecord:
type: object
properties:
callGuid:
type: string
description: Globally unique call identifier
example: '500123'
callStartTime:
type: string
format: date-time
description: Call start timestamp
example: '2026-01-15T10:30:00Z'
callEndTime:
type: string
format: date-time
description: Call end timestamp
example: '2026-01-15T10:30:00Z'
callingNumber:
type: string
description: Caller ANI (Automatic Number Identification)
example: example_value
calledNumber:
type: string
description: Called DNIS (Dialed Number Identification Service)
example: example_value
callResult:
type: string
enum:
- completed
- abandoned
- transferred
- error
description: Final call outcome
example: completed
callDuration:
type: integer
description: Total call duration in seconds
example: 10
selfServiceDuration:
type: integer
description: Duration of self-service (IVR) portion in seconds
example: 10
queueDuration:
type: integer
description: Duration in queue in seconds
example: 10
applicationName:
type: string
description: VXML application that handled the call
example: example_value
callServerHostname:
type: string
description: Call Server that processed the call
example: example_value
vxmlServerHostname:
type: string
description: VXML Server that executed the application
example: example_value
sipCallId:
type: string
description: SIP Call-ID header value
example: '500123'
icmCallKey:
type: string
description: ICM/UCCE call key for correlation
example: example_value
eccVariables:
type: object
additionalProperties:
type: string
description: Expanded Call Context (ECC) variables
example: example_value
transferDestination:
type: string
description: Transfer destination number if the call was transferred
example: example_value
errorCode:
type: string
description: Error code if the call ended in error
example: example_value
Error:
type: object
properties:
code:
type: string
example: example_value
message:
type: string
example: example_value
details:
type: string
example: example_value
timestamp:
type: string
format: date-time
example: '2026-01-15T10:30:00Z'
CallLeg:
type: object
properties:
legId:
type: string
example: '500123'
callGuid:
type: string
example: '500123'
legType:
type: string
enum:
- inbound
- outbound
- transfer
- conference
description: Type of call leg
example: inbound
startTime:
type: string
format: date-time
example: '2026-01-15T10:30:00Z'
endTime:
type: string
format: date-time
example: '2026-01-15T10:30:00Z'
duration:
type: integer
description: Leg duration in seconds
example: 10
fromUri:
type: string
description: SIP From URI
example: example_value
toUri:
type: string
description: SIP To URI
example: example_value
serverHostname:
type: string
description: Server that handled this leg
example: example_value
sipResponseCode:
type: integer
description: Final SIP response code for this leg
example: 10
CdrQueryResult:
type: object
properties:
totalRecords:
type: integer
description: Total number of matching records
example: 10
offset:
type: integer
example: 10
limit:
type: integer
example: 10
records:
type: array
items:
$ref: '#/components/schemas/CallDetailRecord'
example: []
responses:
NotFound:
description: Requested resource not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
InternalError:
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
Unauthorized:
description: Authentication required or credentials invalid
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
BadRequest:
description: Invalid request parameters
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
basicAuth:
type: http
scheme: basic
description: HTTP Basic authentication using CVP reporting credentials