Retrieve paginated Vobiz call detail records with filters for date range, number, direction, and duration - the main endpoint for analytics and billing.
This is the primary endpoint for call analytics and billing review. It returns CDRs newest-first, with a pagination block for paging and a summary block of aggregate metrics across the filtered set. A CDR is written only after a call completes, so very recent calls may take a few seconds to appear.
When to use it
You want to…
Use
Page through call history for analytics or billing review
This endpoint, with start_date and end_date
Find the CDR for one SIP Call-ID or bridged leg
This endpoint, with sip_call_id or bridge_uuid
Review failed calls
This endpoint, with hangup_cause or hangup_disposition
All filters are optional and combine with AND. Apply them as query-string parameters.
Parameter
Type
Default
Notes
from_number
string
-
Originating (caller) number. Substring or full E.164, e.g. 9876543210.
to_number
string
-
Destination (callee) number. Substring or full E.164.
start_date
string YYYY-MM-DD
-
Beginning of the period. Required together withend_date.
end_date
string YYYY-MM-DD
-
End of the period. Required together withstart_date.
call_direction
enum
-
inbound or outbound only.
min_duration
integer
-
Seconds. Excludes calls shorter than this value.
sip_call_id
string
-
The SIP Call-ID of the call, e.g. dD1qwu5VZ5iK3ed5u3uspjY5RKL. Matches the sip_call_id field on the CDR.
bridge_uuid
string
-
UUID of the bridged leg, e.g. 4b7ae653-f40d-42f1-b582-6b05dfcd0c0a. Matches the bridge_uuid field on the CDR.
hangup_cause
string
-
Telephony hangup cause, e.g. NORMAL_CLEARING. See Hangup Causes.
hangup_disposition
string
-
How the leg was released, e.g. send_refuse.
context
string
-
Call context, e.g. sip-trunking.
campaign_id
string
-
Campaign identifier associated with the call.
search
string
-
Free-text search across CDR fields (numbers, IDs, etc.).
page
integer
1
Page number.
per_page
integer
20
Records per page. Max 100.
The from_number / to_number filters map to the caller_id_number / destination_number fields on the returned CDR object - filter on the former, read the latter. The other filters (sip_call_id, bridge_uuid, hangup_cause, hangup_disposition, context, campaign_id) match the same-named CDR fields directly.
Response
The main top-level fields of the response:
Field
Description
account_id
The account this CDR set belongs to.
data
Array of CDR objects for the current page, newest first.
count
Number of records in data.
pagination
Paging state for the filtered set. See Pagination.
The pagination object is { page, per_page, total, pages, has_next, has_prev } - not current_page / total_records. total is the count across all pages and pages = ceil(total / per_page). Loop while has_next is true, incrementing page.
Field
Type
Description
page
integer
Current page.
per_page
integer
Records per page.
total
integer
Total matching records across all pages.
pages
integer
Total number of pages.
has_next
boolean
true if a next page exists.
has_prev
boolean
true if a previous page exists.
Reading the summary
summary is computed over the filtered set, not your whole account:
totalCalls, answeredCalls, answerRate (percent)
avgCallDuration is a string like "28s" - parse it, don’t do arithmetic on it. For numeric work use total_duration_seconds and total_billable_seconds.
total_cost is in the account currency; last_call_at is ISO 8601.
Field
Type
Description
totalCalls
integer
Total calls in the filtered set.
answeredCalls
integer
Calls that were answered (billsec > 0).
answerRate
number
Percentage of calls answered.
avgCallDuration
string
Average duration as a human-readable string, e.g. "28s".
total_duration_seconds
integer
Sum of all duration values.
total_billable_seconds
integer
Sum of all billsec values.
total_cost
number
Sum of all total_cost values in currency.
last_call_at
string (ISO 8601)
Timestamp of the most recent call in the set.
CDR fields
Each item in data is a CDR object with these 43 fields. The CDR overview has the same glossary with notes on conference legs.
Field
Type
Description
id
integer
Internal numeric identifier for the call.
uuid
string (UUID)
Globally unique identifier for the call.
account_id
string
Account that owns this call.
call_direction
string
inbound or outbound.
caller_id_name
string
Caller ID display name.
caller_id_number
string
Originating phone number (E.164 format).
destination_number
string
Destination phone number or destination identifier.
duration
integer
Total call duration in seconds (ring + talk).
billsec
integer
Billable seconds (talk time only).
ring_time
integer
Time the call rang before answer or hangup, in seconds.
answer_time
string (ISO 8601) | null
When the call was answered. null if not answered.
start_time
string (ISO 8601)
When the call was initiated.
end_time
string (ISO 8601)
When the call ended.
progress_time
string (ISO 8601)
When the call entered the progress state.
created_at
string (ISO 8601)
CDR record creation timestamp.
updated_at
string (ISO 8601)
CDR record last-updated timestamp.
cost
number
Per-leg cost in currency.
total_cost
number
Total cost including streaming, in currency.
streaming_cost
number
Cost of audio streaming for this call (if used).
currency
string
ISO currency code, e.g. INR.
hangup_cause
string
High-level hangup reason (e.g. NORMAL_CLEARING). See Hangup Causes.
hangup_cause_code
integer
Numeric hangup code.
hangup_cause_name
string
Human-readable hangup name.
hangup_disposition
string
SIP hangup disposition (e.g. send_bye, recv_bye).
hangup_source
string
Which party initiated the hangup (Caller, Callee, etc.). Not reliable on conference legs - see the CDR overview.
failure_code
string | null
Failure code if the call did not connect.
failure_reason
string | null
Human-readable failure reason.
bridge_uuid
string (UUID) | null
UUID of the call bridge.
sip_call_id
string
SIP-level Call-ID header value.
sip_user_agent
string
SIP User-Agent header value of the originating leg.
codec
string | null
Audio codec negotiated (e.g. PCMU, PCMA, opus).
mos
number
Mean Opinion Score (call audio quality, 1.0–5.0).
jitter
number
Jitter in milliseconds.
packet_loss
number
Packet loss percentage.
network_addr
string
Network address of the call leg.
carrier_ip
string | null
Carrier IP address.
context
string
Internal call context (e.g. voice-api).
region
string
Vobiz infrastructure region (e.g. ap-south-1).
origination_region
string
Region the call originated from.
campaign_id
string | null
Campaign ID if the call is part of a campaign.
customer_endpoint
string | null
Customer endpoint identifier.
trunk_id
string | null
SIP trunk ID used for this call.
terminated_to
string | null
Termination target if forwarded.
Edge cases
No matches: a valid request that matches nothing returns 200 with data: [], count: 0, and a zeroed summary - not a 404.
Quality metrics on unanswered calls:mos, jitter, and packet_loss are often 0 (or null) for calls that never carried media. Treat mos: 0 as “no media”, not “worst quality”.
Unanswered calls have answer_time: null and billsec: 0.
Casing:Account is capitalized and cdr is lowercase in the path.
Example
The first request lists outbound calls of at least 10 seconds in a date range, 50 per page. The second finds the CDRs for one bridged leg or one SIP Call-ID.
# Find the CDR(s) for a specific bridged leg or SIP Call-IDcurl -sS "https://api.vobiz.ai/api/v1/Account/{auth_id}/cdr?bridge_uuid=4b7ae653-f40d-42f1-b582-6b05dfcd0c0a" \ -H "X-Auth-ID: {auth_id}" \ -H "X-Auth-Token: {auth_token}"curl -sS "https://api.vobiz.ai/api/v1/Account/{auth_id}/cdr?sip_call_id=dD1qwu5VZ5iK3ed5u3uspjY5RKL" \ -H "X-Auth-ID: {auth_id}" \ -H "X-Auth-Token: {auth_token}"
See the CDR overview for the complete 43-field glossary and the Hangup Causes reference for decoding hangup_cause / hangup_cause_code.
Authorizations
X-Auth-ID
string
header
required
Your Vobiz account Auth ID
X-Auth-Token
string
header
required
Your Vobiz account Auth Token
Path Parameters
auth_id
string
required
Your account Auth ID
Example:
"MA_XXXXXX"
Query Parameters
from_number
string
Filter by the originating phone number (caller).
Example:
"9876543210"
to_number
string
Filter by the destination phone number (callee).
Example:
"1234567890"
start_date
string<date>
Beginning of the search period (YYYY-MM-DD). Required when using end_date.
Example:
"2026-03-01"
end_date
string<date>
End of the search period (YYYY-MM-DD). Required when using start_date.
Example:
"2026-03-17"
call_direction
enum<string>
Filter by direction.
Available options:
inbound,
outbound
min_duration
integer
Minimum call duration in seconds. Excludes calls shorter than this value.
Example:
10
sip_call_id
string
Filter by the SIP Call-ID of the call (matches the cdr's sip_call_id field).
Example:
"dD1qwu5VZ5iK3ed5u3uspjY5RKL"
bridge_uuid
string
Filter by the UUID of the bridged leg (matches the cdr's bridge_uuid field).
Example:
"4b7ae653-f40d-42f1-b582-6b05dfcd0c0a"
hangup_cause
string
Filter by telephony hangup cause, e.g. NORMAL_CLEARING.
Example:
"NORMAL_CLEARING"
hangup_disposition
string
Filter by how the leg was released, e.g. send_refuse.
Example:
"send_refuse"
context
string
Filter by the call context, e.g. sip-trunking.
Example:
"sip-trunking"
campaign_id
string
Filter by the campaign identifier associated with the call.
search
string
Free-text search across CDR fields (numbers, IDs, etc.).
page
integer
default:1
Page number for paginated results.
per_page
integer
default:20
Number of records per page. Max: 100.
Required range: x <= 100
Response
200 - application/json
Paginated list of CDRs
account_id
string
required
count
integer
required
data
object[]
required
Show child attributes
pagination
object
required
Page-based pagination returned in the pagination object of the CDR list and search endpoints and the partner customer CDR endpoint. Loop while has_next is true, incrementing page.
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Vobiz","colors":{"primary":"#E83C00","light":"#E86A00","dark":"#c93400"},"logo":{"light":"https://mintcdn.com/vobizai/cPP2drhQ7lKsmogc/logo/light.svg?fit=max\u0026auto=format\u0026n=cPP2drhQ7lKsmogc\u0026q=85\u0026s=8e1f6273f626f638f46d6df526d4775c","dark":"https://mintcdn.com/vobizai/cPP2drhQ7lKsmogc/logo/dark.svg?fit=max\u0026auto=format\u0026n=cPP2drhQ7lKsmogc\u0026q=85\u0026s=57b37e5694f01e6933c9ec02a871250a","href":"https://www.vobiz.ai/docs/introduction"},"favicon":"https://mintcdn.com/vobizai/BDRzOqCvIsC8CJvN/favicon.svg?fit=max\u0026auto=format\u0026n=BDRzOqCvIsC8CJvN\u0026q=85\u0026s=b38182f12bc6b0e3a5df2a8ae1474f83","api":{"openapi":["openapi.yaml","openapi-sms.yaml","openapi-whatsapp.yaml"],"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript"],"prefill":true},"mdx":{"auth":{"method":"key","name":"X-Auth-Token"},"server":"https://api.vobiz.ai"}},"appearance":{"default":"dark"},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"mailto:support@vobiz.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://console.vobiz.ai"}},"footer":{"socials":{"x":"https://x.com/Vobiz_Ai","github":"https://github.com/vobiz-ai","linkedin":"https://linkedin.com/company/vobizai"}},"seo":{"metatags":{"canonical":"https://www.vobiz.ai/docs","og:site_name":"Vobiz Docs","og:type":"website","og:locale":"en_US","twitter:card":"summary_large_image","twitter:site":"@Vobiz_Ai","twitter:creator":"@Vobiz_Ai","theme-color":"#E83C00","color-scheme":"dark light","author":"Vobiz","publisher":"Vobiz","copyright":"Copyright 2025 Vobiz","reply-to":"support@vobiz.ai","robots":"index, follow","format-detection":"telephone=no","referrer":"origin-when-cross-origin","rating":"general","language":"en","category":"Technology","coverage":"Worldwide","distribution":"global","target":"all"},"indexing":"all"},"integrations":{"ga4":{"measurementId":"G-YD6M3FF3P4"}},"contextual":{"options":["copy","view","assistant","chatgpt","claude","perplexity","mcp","add-mcp","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"dark"},"markdown":{"schema":true},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"API Status","icon":"signal","href":"https://status.vobiz.ai"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"vobizai","hasAudioNarration":false,"actualSubdomain":"vobizai","customDomains":["www.vobiz.ai"],"gitSource":{"type":"github","owner":"vobiz-ai","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6ae8948acb9fa025302af88e"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6b00db3c4dbe5d10f9185131","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":386},{"language":"default","tag":"Voice \u0026 XML","count":119},{"language":"default","tag":"Documentation","count":99},{"language":"default","tag":"SMS \u0026 RCS","count":92},{"language":"default","tag":"Blogs","count":82},{"language":"default","tag":"Articles","count":80},{"language":"default","tag":"Integrations","count":79},{"language":"default","tag":"Examples \u0026 Tutorials","count":59},{"language":"default","tag":"Regular APIs","count":40},{"language":"default","tag":"SIP Trunking","count":32}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@vobiz.ai","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","href":"/docs/_mintlify/custom/vobizai/c4c76a1b5bc930af/custom.css"}]}
{"page":{"pagePath":"cdr/list-cdrs","slug":"/cdr/list-cdrs","pageMetadata":{"title":"List CDRs","openapi":"GET /api/v1/Account/{auth_id}/cdr","description":"Retrieve paginated Vobiz call detail records with filters for date range, number, direction, and duration - the main endpoint for analytics and billing.","keywords":["list CDRs Vobiz","call detail records API","CDR pagination","filter CDRs date range","from_number to_number filter","min_duration filter","call_direction filter","filter CDR bridge_uuid","filter CDR sip_call_id","hangup_cause filter","hangup_disposition filter","context filter","campaign_id filter","CDR search filter","Vobiz CDR list","call logs API","telephony CDR","CDR filter API","call history API","CDR inbound outbound filter","CDR billing review","call detail API"],"href":"/cdr/list-cdrs"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retrieve paginated Vobiz call detail records with filters for date range, number, direction, and duration - the main endpoint for analytics and billing.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`This is the primary endpoint for call analytics and billing review. It returns CDRs newest-first, with a `,_jsx(_components.code,{children:`pagination`}),` block for paging and a `,_jsx(_components.code,{children:`summary`}),` block of aggregate metrics across the filtered set. A CDR is written only after a call completes, so very recent calls may take a few seconds to appear.`]}),`\n`,_jsx(Heading,{level:`2`,id:`when-to-use-it`,children:`When to use it`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`You want to…`}),_jsx(_components.th,{children:`Use`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Page through call history for analytics or billing review`}),_jsxs(_components.td,{children:[`This endpoint, with `,_jsx(_components.code,{children:`start_date`}),` and `,_jsx(_components.code,{children:`end_date`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Find the CDR for one SIP `,_jsx(_components.code,{children:`Call-ID`}),` or bridged leg`]}),_jsxs(_components.td,{children:[`This endpoint, with `,_jsx(_components.code,{children:`sip_call_id`}),` or `,_jsx(_components.code,{children:`bridge_uuid`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Review failed calls`}),_jsxs(_components.td,{children:[`This endpoint, with `,_jsx(_components.code,{children:`hangup_cause`}),` or `,_jsx(_components.code,{children:`hangup_disposition`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Show the active filters in a search UI`}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/cdr/search-cdrs`,children:`Search CDRs`}),`, which also echoes a `,_jsx(_components.code,{children:`filters`}),` object`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Fetch one call by its `,_jsx(_components.code,{children:`call_id`})]}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/cdr/get-cdr`,children:`Get Single CDR`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Get the latest calls without a date range`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/cdr/recent-cdrs`,children:`Recent CDRs`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Download the filtered set as a CSV file`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/cdr/export-cdrs`,children:`Export CDRs as CSV`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`filters`,children:`Filters`}),`\n`,_jsx(_components.p,{children:`All filters are optional and combine with AND. Apply them as query-string parameters.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Default`}),_jsx(_components.th,{children:`Notes`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`from_number`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`-`}),_jsxs(_components.td,{children:[`Originating (caller) number. Substring or full E.164, e.g. `,_jsx(_components.code,{children:`9876543210`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`to_number`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`-`}),_jsx(_components.td,{children:`Destination (callee) number. Substring or full E.164.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`start_date`})}),_jsxs(_components.td,{children:[`string `,_jsx(_components.code,{children:`YYYY-MM-DD`})]}),_jsx(_components.td,{\"data-numeric\":`true`,children:`-`}),_jsxs(_components.td,{children:[`Beginning of the period. `,_jsx(_components.strong,{children:`Required together with`}),` `,_jsx(_components.code,{children:`end_date`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`end_date`})}),_jsxs(_components.td,{children:[`string `,_jsx(_components.code,{children:`YYYY-MM-DD`})]}),_jsx(_components.td,{\"data-numeric\":`true`,children:`-`}),_jsxs(_components.td,{children:[`End of the period. `,_jsx(_components.strong,{children:`Required together with`}),` `,_jsx(_components.code,{children:`start_date`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`call_direction`})}),_jsx(_components.td,{children:`enum`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`-`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`inbound`}),` or `,_jsx(_components.code,{children:`outbound`}),` only.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`min_duration`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`-`}),_jsx(_components.td,{children:`Seconds. Excludes calls shorter than this value.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sip_call_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`-`}),_jsxs(_components.td,{children:[`The SIP `,_jsx(_components.code,{children:`Call-ID`}),` of the call, e.g. `,_jsx(_components.code,{children:`dD1qwu5VZ5iK3ed5u3uspjY5RKL`}),`. Matches the `,_jsx(_components.code,{children:`sip_call_id`}),` field on the CDR.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`bridge_uuid`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`-`}),_jsxs(_components.td,{children:[`UUID of the bridged leg, e.g. `,_jsx(_components.code,{children:`4b7ae653-f40d-42f1-b582-6b05dfcd0c0a`}),`. Matches the `,_jsx(_components.code,{children:`bridge_uuid`}),` field on the CDR.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`hangup_cause`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`-`}),_jsxs(_components.td,{children:[`Telephony hangup cause, e.g. `,_jsx(_components.code,{children:`NORMAL_CLEARING`}),`. See `,_jsx(_components.a,{href:`/concepts/hangup-causes`,children:`Hangup Causes`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`hangup_disposition`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`-`}),_jsxs(_components.td,{children:[`How the leg was released, e.g. `,_jsx(_components.code,{children:`send_refuse`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`context`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`-`}),_jsxs(_components.td,{children:[`Call context, e.g. `,_jsx(_components.code,{children:`sip-trunking`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`campaign_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`-`}),_jsx(_components.td,{children:`Campaign identifier associated with the call.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`search`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`-`}),_jsx(_components.td,{children:`Free-text search across CDR fields (numbers, IDs, etc.).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`page`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1`})}),_jsx(_components.td,{children:`Page number.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`per_page`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`20`})}),_jsxs(_components.td,{children:[`Records per page. Max `,_jsx(_components.code,{children:`100`}),`.`]})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`from_number`}),` / `,_jsx(_components.code,{children:`to_number`}),` filters map to the `,_jsx(_components.code,{children:`caller_id_number`}),` / `,_jsx(_components.code,{children:`destination_number`}),` fields on the returned CDR object - filter on the former, read the latter. The other filters (`,_jsx(_components.code,{children:`sip_call_id`}),`, `,_jsx(_components.code,{children:`bridge_uuid`}),`, `,_jsx(_components.code,{children:`hangup_cause`}),`, `,_jsx(_components.code,{children:`hangup_disposition`}),`, `,_jsx(_components.code,{children:`context`}),`, `,_jsx(_components.code,{children:`campaign_id`}),`) match the same-named CDR fields directly.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(_components.p,{children:`The main top-level fields of the response:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`account_id`})}),_jsx(_components.td,{children:`The account this CDR set belongs to.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data`})}),_jsx(_components.td,{children:`Array of CDR objects for the current page, newest first.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`count`})}),_jsxs(_components.td,{children:[`Number of records in `,_jsx(_components.code,{children:`data`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pagination`})}),_jsxs(_components.td,{children:[`Paging state for the filtered set. See `,_jsx(_components.a,{href:`#pagination`,children:`Pagination`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`summary`})}),_jsxs(_components.td,{children:[`Aggregate metrics for the filtered set. See `,_jsx(_components.a,{href:`#reading-the-summary`,children:`Reading the summary`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`success`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`true`}),` on a successful response.`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/cdr#top-level-fields`,children:`Top-level fields`}),` in the CDR overview for the full envelope.`]}),`\n`,_jsx(Heading,{level:`2`,id:`pagination`,children:`Pagination`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`pagination`}),` object is `,_jsx(_components.code,{children:`{ page, per_page, total, pages, has_next, has_prev }`}),` - not `,_jsx(_components.code,{children:`current_page`}),` / `,_jsx(_components.code,{children:`total_records`}),`. `,_jsx(_components.code,{children:`total`}),` is the count across all pages and `,_jsx(_components.code,{children:`pages = ceil(total / per_page)`}),`. Loop while `,_jsx(_components.code,{children:`has_next`}),` is `,_jsx(_components.code,{children:`true`}),`, incrementing `,_jsx(_components.code,{children:`page`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`page`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Current page.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`per_page`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Records per page.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`total`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Total matching records across all pages.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pages`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Total number of pages.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`has_next`})}),_jsx(_components.td,{children:`boolean`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`true`}),` if a next page exists.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`has_prev`})}),_jsx(_components.td,{children:`boolean`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`true`}),` if a previous page exists.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`reading-the-summary`,children:`Reading the summary`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`summary`}),` is computed over the `,_jsx(_components.strong,{children:`filtered`}),` set, not your whole account:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`totalCalls`}),`, `,_jsx(_components.code,{children:`answeredCalls`}),`, `,_jsx(_components.code,{children:`answerRate`}),` (percent)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`avgCallDuration`}),` is a `,_jsx(_components.strong,{children:`string`}),` like `,_jsx(_components.code,{children:`\"28s\"`}),` - parse it, don’t do arithmetic on it. For numeric work use `,_jsx(_components.code,{children:`total_duration_seconds`}),` and `,_jsx(_components.code,{children:`total_billable_seconds`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`total_cost`}),` is in the account `,_jsx(_components.code,{children:`currency`}),`; `,_jsx(_components.code,{children:`last_call_at`}),` is ISO 8601.`]}),`\n`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`totalCalls`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Total calls in the filtered set.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`answeredCalls`})}),_jsx(_components.td,{children:`integer`}),_jsxs(_components.td,{children:[`Calls that were answered (`,_jsx(_components.code,{children:`billsec`}),` > 0).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`answerRate`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Percentage of calls answered.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`avgCallDuration`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Average duration as a human-readable string, e.g. `,_jsx(_components.code,{children:`\"28s\"`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`total_duration_seconds`})}),_jsx(_components.td,{children:`integer`}),_jsxs(_components.td,{children:[`Sum of all `,_jsx(_components.code,{children:`duration`}),` values.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`total_billable_seconds`})}),_jsx(_components.td,{children:`integer`}),_jsxs(_components.td,{children:[`Sum of all `,_jsx(_components.code,{children:`billsec`}),` values.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`total_cost`})}),_jsx(_components.td,{children:`number`}),_jsxs(_components.td,{children:[`Sum of all `,_jsx(_components.code,{children:`total_cost`}),` values in `,_jsx(_components.code,{children:`currency`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`last_call_at`})}),_jsx(_components.td,{children:`string (ISO 8601)`}),_jsx(_components.td,{children:`Timestamp of the most recent call in the set.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`cdr-fields`,children:`CDR fields`}),`\n`,_jsxs(_components.p,{children:[`Each item in `,_jsx(_components.code,{children:`data`}),` is a CDR object with these 43 fields. The `,_jsx(_components.a,{href:`/cdr#cdr-object-every-field`,children:`CDR overview`}),` has the same glossary with notes on conference legs.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`id`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Internal numeric identifier for the call.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`uuid`})}),_jsx(_components.td,{children:`string (UUID)`}),_jsx(_components.td,{children:`Globally unique identifier for the call.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`account_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Account that owns this call.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`call_direction`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`inbound`}),` or `,_jsx(_components.code,{children:`outbound`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`caller_id_name`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Caller ID display name.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`caller_id_number`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Originating phone number (E.164 format).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`destination_number`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Destination phone number or destination identifier.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`duration`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Total call duration in seconds (ring + talk).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`billsec`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Billable seconds (talk time only).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ring_time`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Time the call rang before answer or hangup, in seconds.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`answer_time`})}),_jsx(_components.td,{children:`string (ISO 8601) | null`}),_jsxs(_components.td,{children:[`When the call was answered. `,_jsx(_components.code,{children:`null`}),` if not answered.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`start_time`})}),_jsx(_components.td,{children:`string (ISO 8601)`}),_jsx(_components.td,{children:`When the call was initiated.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`end_time`})}),_jsx(_components.td,{children:`string (ISO 8601)`}),_jsx(_components.td,{children:`When the call ended.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`progress_time`})}),_jsx(_components.td,{children:`string (ISO 8601)`}),_jsx(_components.td,{children:`When the call entered the progress state.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`created_at`})}),_jsx(_components.td,{children:`string (ISO 8601)`}),_jsx(_components.td,{children:`CDR record creation timestamp.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updated_at`})}),_jsx(_components.td,{children:`string (ISO 8601)`}),_jsx(_components.td,{children:`CDR record last-updated timestamp.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`cost`})}),_jsx(_components.td,{children:`number`}),_jsxs(_components.td,{children:[`Per-leg cost in `,_jsx(_components.code,{children:`currency`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`total_cost`})}),_jsx(_components.td,{children:`number`}),_jsxs(_components.td,{children:[`Total cost including streaming, in `,_jsx(_components.code,{children:`currency`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`streaming_cost`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Cost of audio streaming for this call (if used).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`currency`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`ISO currency code, e.g. `,_jsx(_components.code,{children:`INR`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`hangup_cause`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`High-level hangup reason (e.g. `,_jsx(_components.code,{children:`NORMAL_CLEARING`}),`). See `,_jsx(_components.a,{href:`/concepts/hangup-causes`,children:`Hangup Causes`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`hangup_cause_code`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Numeric hangup code.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`hangup_cause_name`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Human-readable hangup name.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`hangup_disposition`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`SIP hangup disposition (e.g. `,_jsx(_components.code,{children:`send_bye`}),`, `,_jsx(_components.code,{children:`recv_bye`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`hangup_source`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Which party initiated the hangup (`,_jsx(_components.code,{children:`Caller`}),`, `,_jsx(_components.code,{children:`Callee`}),`, etc.). `,_jsx(_components.strong,{children:`Not reliable on conference legs`}),` - see the `,_jsx(_components.a,{href:`/cdr#cdr-object-every-field`,children:`CDR overview`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`failure_code`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`Failure code if the call did not connect.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`failure_reason`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`Human-readable failure reason.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`bridge_uuid`})}),_jsx(_components.td,{children:`string (UUID) | null`}),_jsx(_components.td,{children:`UUID of the call bridge.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sip_call_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`SIP-level Call-ID header value.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sip_user_agent`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`SIP User-Agent header value of the originating leg.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`codec`})}),_jsx(_components.td,{children:`string | null`}),_jsxs(_components.td,{children:[`Audio codec negotiated (e.g. `,_jsx(_components.code,{children:`PCMU`}),`, `,_jsx(_components.code,{children:`PCMA`}),`, `,_jsx(_components.code,{children:`opus`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`mos`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Mean Opinion Score (call audio quality, 1.0–5.0).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`jitter`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Jitter in milliseconds.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`packet_loss`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Packet loss percentage.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`network_addr`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Network address of the call leg.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`carrier_ip`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`Carrier IP address.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`context`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Internal call context (e.g. `,_jsx(_components.code,{children:`voice-api`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`region`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Vobiz infrastructure region (e.g. `,_jsx(_components.code,{children:`ap-south-1`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`origination_region`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Region the call originated from.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`campaign_id`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`Campaign ID if the call is part of a campaign.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`customer_endpoint`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`Customer endpoint identifier.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`trunk_id`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`SIP trunk ID used for this call.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`terminated_to`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`Termination target if forwarded.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`edge-cases`,children:`Edge cases`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`No matches:`}),` a valid request that matches nothing returns `,_jsx(_components.code,{children:`200`}),` with `,_jsx(_components.code,{children:`data: []`}),`, `,_jsx(_components.code,{children:`count: 0`}),`, and a zeroed `,_jsx(_components.code,{children:`summary`}),` - not a `,_jsx(_components.code,{children:`404`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Quality metrics on unanswered calls:`}),` `,_jsx(_components.code,{children:`mos`}),`, `,_jsx(_components.code,{children:`jitter`}),`, and `,_jsx(_components.code,{children:`packet_loss`}),` are often `,_jsx(_components.code,{children:`0`}),` (or `,_jsx(_components.code,{children:`null`}),`) for calls that never carried media. Treat `,_jsx(_components.code,{children:`mos: 0`}),` as “no media”, not “worst quality”.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Unanswered calls`}),` have `,_jsx(_components.code,{children:`answer_time: null`}),` and `,_jsx(_components.code,{children:`billsec: 0`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Casing:`}),` `,_jsx(_components.code,{children:`Account`}),` is capitalized and `,_jsx(_components.code,{children:`cdr`}),` is lowercase in the path.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`example`,children:`Example`}),`\n`,_jsxs(_components.p,{children:[`The first request lists outbound calls of at least 10 seconds in a date range, 50 per page. The second finds the CDRs for one bridged leg or one SIP `,_jsx(_components.code,{children:`Call-ID`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:`Filter by date range`,numberOfLines:`8`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -G`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.vobiz.ai/api/v1/Account/{auth_id}/cdr\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"start_date=2026-03-01\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"end_date=2026-03-17\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"call_direction=outbound\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"min_duration=10\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"page=1\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"per_page=50\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-ID: {auth_id}\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-Token: {auth_token}\"`})]}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:`Filter by bridge / SIP call id`,numberOfLines:`8`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Find the CDR(s) for a specific bridged leg or SIP Call-ID`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -sS`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.vobiz.ai/api/v1/Account/{auth_id}/cdr?bridge_uuid=4b7ae653-f40d-42f1-b582-6b05dfcd0c0a\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-ID: {auth_id}\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-Token: {auth_token}\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -sS`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.vobiz.ai/api/v1/Account/{auth_id}/cdr?sip_call_id=dD1qwu5VZ5iK3ed5u3uspjY5RKL\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-ID: {auth_id}\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-Token: {auth_token}\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/cdr`,children:`CDR overview`}),` for the complete 43-field glossary and the `,_jsx(_components.a,{href:`/concepts/hangup-causes`,children:`Hangup Causes`}),` reference for decoding `,_jsx(_components.code,{children:`hangup_cause`}),` / `,_jsx(_components.code,{children:`hangup_cause_code`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List CDRs","openapi":"GET /api/v1/Account/{auth_id}/cdr","description":"Retrieve paginated Vobiz call detail records with filters for date range, number, direction, and duration - the main endpoint for analytics and billing.","keywords":["list CDRs Vobiz","call detail records API","CDR pagination","filter CDRs date range","from_number to_number filter","min_duration filter","call_direction filter","filter CDR bridge_uuid","filter CDR sip_call_id","hangup_cause filter","hangup_disposition filter","context filter","campaign_id filter","CDR search filter","Vobiz CDR list","call logs API","telephony CDR","CDR filter API","call history API","CDR inbound outbound filter","CDR billing review","call detail API"],"href":"/cdr/list-cdrs"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"When to use it","slug":"when-to-use-it","depth":2,"children":[]},{"title":"Filters","slug":"filters","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Pagination","slug":"pagination","depth":2,"children":[]},{"title":"Reading the summary","slug":"reading-the-summary","depth":2,"children":[]},{"title":"CDR fields","slug":"cdr-fields","depth":2,"children":[]},{"title":"Edge cases","slug":"edge-cases","depth":2,"children":[]},{"title":"Example","slug":"example","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/vobizai/478834ae2c200a0e/blog-schema.js","/docs/_mintlify/custom/vobizai/13b0cd7ec6e39877/anchor-link-text.js"],"openApiReferenceData":{"operation":{"operationId":"list-cdrs","summary":"List call records","description":"Retrieve paginated Vobiz call detail records with filters for date range, number, direction, and duration - the main endpoint for analytics and billing.","tags":["CDR"],"parameters":["3893e493-b9c0-4f50-afcb-89c17fcd1193","5fdafd50-be34-4f98-b62e-04a86032d516","b8c4124c-faf6-405c-b0a2-d56f50dec181","399607ef-5f30-4240-a23c-2eb26bbba69d","b629d3c5-3ed6-4b27-b2fc-eaa29c06320f","868f417f-03d0-43a1-8730-5c5213ee4721","094a0ac9-0626-4053-a525-d1069cc1b4b1","e6f33cf4-9581-471e-9ed5-ad0d6f5e506e","ca488adc-36c5-4309-83eb-8e850a2b0e82","3104418c-e887-4936-a836-4041ec4da821","7666569b-c65e-44d1-b1f7-1a8f9c2c4608","c34e1353-cb35-4b8d-bdcb-c0564a1ad660","660e494b-a0ec-49a9-aab8-81583b99bdbf","b855740b-bef5-4cb1-9ba4-daf402c4a55f","b3e4ca01-7771-4bab-9271-45bbfc4fc5a7","317e904e-4e9d-4d4e-8b17-80b6a936a45f"],"responses":{"200":"19954f43-2c51-4c08-a851-edbf6f38a76e"},"method":"get","type":"path","servers":["63df1293-34a2-4314-96e6-4cfcad0f4404"],"security":["c50d337f-92a2-4e86-b2c1-8be733ff0e0b"],"path":"/api/v1/Account/{auth_id}/cdr","baseUrlOptions":["https://api.vobiz.ai"],"title":"List call records","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{"3893e493-b9c0-4f50-afcb-89c17fcd1193":{"name":"auth_id","in":"path","required":true,"description":"Your account Auth ID","schema":{"type":"string","example":"MA_XXXXXX","isRequired":true,"description":"Your account Auth ID","uniqueKey":"","typeLabel":"string"}},"5fdafd50-be34-4f98-b62e-04a86032d516":{"name":"from_number","in":"query","description":"Filter by the originating phone number (caller).","schema":{"type":"string","example":"9876543210","description":"Filter by the originating phone number (caller).","uniqueKey":"","typeLabel":"string"}},"b8c4124c-faf6-405c-b0a2-d56f50dec181":{"name":"to_number","in":"query","description":"Filter by the destination phone number (callee).","schema":{"type":"string","example":"1234567890","description":"Filter by the destination phone number (callee).","uniqueKey":"","typeLabel":"string"}},"399607ef-5f30-4240-a23c-2eb26bbba69d":{"name":"start_date","in":"query","description":"Beginning of the search period (YYYY-MM-DD). Required when using `end_date`.","schema":{"type":"string","format":"date","example":"2026-03-01","description":"Beginning of the search period (YYYY-MM-DD). Required when using `end_date`.","uniqueKey":"","typeLabel":"string\u003cdate>"}},"b629d3c5-3ed6-4b27-b2fc-eaa29c06320f":{"name":"end_date","in":"query","description":"End of the search period (YYYY-MM-DD). Required when using `start_date`.","schema":{"type":"string","format":"date","example":"2026-03-17","description":"End of the search period (YYYY-MM-DD). Required when using `start_date`.","uniqueKey":"","typeLabel":"string\u003cdate>"}},"868f417f-03d0-43a1-8730-5c5213ee4721":{"name":"call_direction","in":"query","description":"Filter by direction.","schema":{"type":"string","enum":["inbound","outbound"],"description":"Filter by direction.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"094a0ac9-0626-4053-a525-d1069cc1b4b1":{"name":"min_duration","in":"query","description":"Minimum call duration in seconds. Excludes calls shorter than this value.","schema":{"type":"integer","example":10,"description":"Minimum call duration in seconds. Excludes calls shorter than this value.","uniqueKey":"","typeLabel":"integer"}},"e6f33cf4-9581-471e-9ed5-ad0d6f5e506e":{"name":"sip_call_id","in":"query","description":"Filter by the SIP Call-ID of the call (matches the cdr's sip_call_id field).","schema":{"type":"string","example":"dD1qwu5VZ5iK3ed5u3uspjY5RKL","description":"Filter by the SIP Call-ID of the call (matches the cdr's sip_call_id field).","uniqueKey":"","typeLabel":"string"}},"ca488adc-36c5-4309-83eb-8e850a2b0e82":{"name":"bridge_uuid","in":"query","description":"Filter by the UUID of the bridged leg (matches the cdr's bridge_uuid field).","schema":{"type":"string","example":"4b7ae653-f40d-42f1-b582-6b05dfcd0c0a","description":"Filter by the UUID of the bridged leg (matches the cdr's bridge_uuid field).","uniqueKey":"","typeLabel":"string"}},"3104418c-e887-4936-a836-4041ec4da821":{"name":"hangup_cause","in":"query","description":"Filter by telephony hangup cause, e.g. NORMAL_CLEARING.","schema":{"type":"string","example":"NORMAL_CLEARING","description":"Filter by telephony hangup cause, e.g. NORMAL_CLEARING.","uniqueKey":"","typeLabel":"string"}},"7666569b-c65e-44d1-b1f7-1a8f9c2c4608":{"name":"hangup_disposition","in":"query","description":"Filter by how the leg was released, e.g. send_refuse.","schema":{"type":"string","example":"send_refuse","description":"Filter by how the leg was released, e.g. send_refuse.","uniqueKey":"","typeLabel":"string"}},"c34e1353-cb35-4b8d-bdcb-c0564a1ad660":{"name":"context","in":"query","description":"Filter by the call context, e.g. sip-trunking.","schema":{"type":"string","example":"sip-trunking","description":"Filter by the call context, e.g. sip-trunking.","uniqueKey":"","typeLabel":"string"}},"660e494b-a0ec-49a9-aab8-81583b99bdbf":{"name":"campaign_id","in":"query","description":"Filter by the campaign identifier associated with the call.","schema":{"type":"string","description":"Filter by the campaign identifier associated with the call.","uniqueKey":"","typeLabel":"string"}},"b855740b-bef5-4cb1-9ba4-daf402c4a55f":{"name":"search","in":"query","description":"Free-text search across CDR fields (numbers, IDs, etc.).","schema":{"type":"string","description":"Free-text search across CDR fields (numbers, IDs, etc.).","uniqueKey":"","typeLabel":"string"}},"b3e4ca01-7771-4bab-9271-45bbfc4fc5a7":{"name":"page","in":"query","description":"Page number for paginated results.","schema":{"type":"integer","default":1,"description":"Page number for paginated results.","uniqueKey":"","typeLabel":"integer"}},"317e904e-4e9d-4d4e-8b17-80b6a936a45f":{"name":"per_page","in":"query","description":"Number of records per page. Max: 100.","schema":{"type":"integer","default":20,"maximum":100,"description":"Number of records per page. Max: 100.","uniqueKey":"","typeLabel":"integer"}}},"responses":{"19954f43-2c51-4c08-a851-edbf6f38a76e":{"description":"Paginated list of CDRs","content":{"application/json":{"schema":{"type":"object","properties":{"account_id":{"type":"string","isRequired":true,"uniqueKey":"account_id","typeLabel":"string"},"count":{"type":"integer","isRequired":true,"uniqueKey":"count","typeLabel":"integer"},"data":{"type":"array","items":{"type":"object","properties":{"account_id":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].account_id","typeLabel":"string"},"answer_time":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].answer_time.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].answer_time.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].answer_time","typeLabel":"string | null"},"billsec":{"type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].billsec","typeLabel":"integer"},"bridge_uuid":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].bridge_uuid.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].bridge_uuid.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].bridge_uuid","typeLabel":"string | null"},"call_direction":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].call_direction","typeLabel":"string"},"caller_id_name":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].caller_id_name","typeLabel":"string"},"caller_id_number":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].caller_id_number","typeLabel":"string"},"campaign_id":{"oneOf":[{"isRequired":true},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].campaign_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].campaign_id","typeLabel":"null"},"carrier_ip":{"oneOf":[{"isRequired":true},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].carrier_ip.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].carrier_ip","typeLabel":"null"},"codec":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].codec.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].codec.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].codec","typeLabel":"string | null"},"context":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].context","typeLabel":"string"},"cost":{"type":"number","isRequired":true,"uniqueKey":"data.items.[INDEX].cost","typeLabel":"number"},"created_at":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].created_at","typeLabel":"string"},"currency":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].currency","typeLabel":"string"},"customer_endpoint":{"oneOf":[{"isRequired":true},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].customer_endpoint.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].customer_endpoint","typeLabel":"null"},"destination_number":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].destination_number","typeLabel":"string"},"duration":{"type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].duration","typeLabel":"integer"},"end_time":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].end_time","typeLabel":"string"},"failure_code":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].failure_code.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].failure_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].failure_code","typeLabel":"string | null"},"failure_reason":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].failure_reason.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].failure_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].failure_reason","typeLabel":"string | null"},"hangup_cause":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].hangup_cause.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].hangup_cause.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].hangup_cause","typeLabel":"string | null"},"hangup_cause_code":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].hangup_cause_code.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].hangup_cause_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].hangup_cause_code","typeLabel":"integer | null"},"hangup_cause_name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].hangup_cause_name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].hangup_cause_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].hangup_cause_name","typeLabel":"string | null"},"hangup_disposition":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].hangup_disposition.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].hangup_disposition.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].hangup_disposition","typeLabel":"string | null"},"hangup_source":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].hangup_source.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].hangup_source.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].hangup_source","typeLabel":"string | null"},"id":{"type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].id","typeLabel":"integer"},"jitter":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.items.[INDEX].jitter.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].jitter.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].jitter","typeLabel":"number | null"},"mos":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.items.[INDEX].mos.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].mos.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].mos","typeLabel":"number | null"},"network_addr":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].network_addr.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].network_addr.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].network_addr","typeLabel":"string | null"},"origination_region":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].origination_region","typeLabel":"string"},"packet_loss":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.items.[INDEX].packet_loss.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].packet_loss.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].packet_loss","typeLabel":"number | null"},"progress_time":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].progress_time.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].progress_time.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].progress_time","typeLabel":"string | null"},"region":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].region","typeLabel":"string"},"ring_time":{"type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].ring_time","typeLabel":"integer"},"sip_call_id":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].sip_call_id","typeLabel":"string"},"sip_user_agent":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].sip_user_agent.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].sip_user_agent.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].sip_user_agent","typeLabel":"string | null"},"start_time":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].start_time","typeLabel":"string"},"streaming_cost":{"type":"number","isRequired":true,"uniqueKey":"data.items.[INDEX].streaming_cost","typeLabel":"number"},"terminated_to":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].terminated_to.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].terminated_to.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].terminated_to","typeLabel":"string | null"},"total_cost":{"type":"number","isRequired":true,"uniqueKey":"data.items.[INDEX].total_cost","typeLabel":"number"},"trunk_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].trunk_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].trunk_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].trunk_id","typeLabel":"string | null"},"updated_at":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].updated_at","typeLabel":"string"},"uuid":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].uuid","typeLabel":"string"}},"required":["account_id","answer_time","billsec","bridge_uuid","call_direction","caller_id_name","caller_id_number","campaign_id","carrier_ip","codec","context","cost","created_at","currency","customer_endpoint","destination_number","duration","end_time","failure_code","failure_reason","hangup_cause","hangup_cause_code","hangup_cause_name","hangup_disposition","hangup_source","id","jitter","mos","network_addr","origination_region","packet_loss","progress_time","region","ring_time","sip_call_id","sip_user_agent","start_time","streaming_cost","terminated_to","total_cost","trunk_id","updated_at","uuid"],"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"pagination":{"type":"object","description":"Page-based pagination returned in the `pagination` object of the CDR list and search endpoints and the partner customer CDR endpoint. Loop while `has_next` is `true`, incrementing `page`.","properties":{"page":{"type":"integer","description":"Current page number, starting at 1.","example":1,"isRequired":true,"uniqueKey":"pagination.page","typeLabel":"integer"},"per_page":{"type":"integer","description":"Number of records per page, as set by the `per_page` query parameter.","example":20,"isRequired":true,"uniqueKey":"pagination.per_page","typeLabel":"integer"},"total":{"type":"integer","description":"Total number of records that match the filters across all pages.","example":4500,"isRequired":true,"uniqueKey":"pagination.total","typeLabel":"integer"},"pages":{"type":"integer","description":"Total number of pages, `ceil(total / per_page)`.","example":225,"isRequired":true,"uniqueKey":"pagination.pages","typeLabel":"integer"},"has_next":{"type":"boolean","description":"`true` when a page after this one exists.","example":true,"isRequired":true,"uniqueKey":"pagination.has_next","typeLabel":"boolean"},"has_prev":{"type":"boolean","description":"`true` when a page before this one exists.","example":false,"isRequired":true,"uniqueKey":"pagination.has_prev","typeLabel":"boolean"}},"required":["page","per_page","total","pages","has_next","has_prev"],"isRequired":true,"uniqueKey":"pagination","typeLabel":"object"},"success":{"type":"boolean","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"summary":{"type":"object","properties":{"answerRate":{"type":"number","isRequired":true,"uniqueKey":"summary.answerRate","typeLabel":"number"},"answeredCalls":{"type":"integer","isRequired":true,"uniqueKey":"summary.answeredCalls","typeLabel":"integer"},"avgCallDuration":{"type":"string","isRequired":true,"uniqueKey":"summary.avgCallDuration","typeLabel":"string"},"last_call_at":{"type":"string","isRequired":true,"uniqueKey":"summary.last_call_at","typeLabel":"string"},"totalCalls":{"type":"integer","isRequired":true,"uniqueKey":"summary.totalCalls","typeLabel":"integer"},"total_billable_seconds":{"type":"integer","isRequired":true,"uniqueKey":"summary.total_billable_seconds","typeLabel":"integer"},"total_cost":{"type":"number","isRequired":true,"uniqueKey":"summary.total_cost","typeLabel":"number"},"total_duration_seconds":{"type":"integer","isRequired":true,"uniqueKey":"summary.total_duration_seconds","typeLabel":"integer"}},"required":["answerRate","answeredCalls","avgCallDuration","last_call_at","totalCalls","total_billable_seconds","total_cost","total_duration_seconds"],"isRequired":true,"uniqueKey":"summary","typeLabel":"object"}},"required":["account_id","count","data","pagination","success","summary"],"uniqueKey":"","typeLabel":"object"},"example":{"account_id":"MA_XXXXXXXX","count":2,"data":[{"account_id":"MA_XXXXXXXX","answer_time":"2026-03-25T10:00:01Z","billsec":42,"bridge_uuid":"aabbccdd-1234-5678-90ab-cdef12345678","call_direction":"outbound","caller_id_name":"John Doe","caller_id_number":"+919876543210","campaign_id":null,"carrier_ip":"10.0.0.1","codec":"PCMU","context":"voice-api","cost":0.45,"created_at":"2026-03-25T10:00:42Z","currency":"INR","customer_endpoint":null,"destination_number":"+918012345678","duration":47,"end_time":"2026-03-25T10:00:42Z","failure_code":null,"failure_reason":null,"hangup_cause":"NORMAL_CLEARING","hangup_cause_code":4000,"hangup_cause_name":"Normal Hangup","hangup_disposition":"send_bye","hangup_source":"Caller","id":18000000,"jitter":0.2,"mos":4.5,"network_addr":"10.0.0.1","origination_region":"mumbai","packet_loss":0.1,"progress_time":"2026-03-25T10:00:00Z","region":"ap-south-1","ring_time":5,"sip_call_id":"11223344-5566-7788-99aa-bbccddeeff00","sip_user_agent":"Vobiz","start_time":"2026-03-25T10:00:00Z","streaming_cost":0,"terminated_to":null,"total_cost":0.45,"trunk_id":null,"updated_at":"2026-03-25T10:00:42Z","uuid":"aabbccdd-1234-5678-90ab-cdef12345678"},{"account_id":"MA_XXXXXXXX","answer_time":null,"billsec":0,"bridge_uuid":null,"call_direction":"inbound","caller_id_name":"","caller_id_number":"+919876543210","campaign_id":null,"carrier_ip":null,"codec":"PCMU","context":"voice-api","cost":0,"created_at":"2026-03-25T09:30:12Z","currency":"INR","customer_endpoint":null,"destination_number":"+918012345678","duration":12,"end_time":"2026-03-25T09:30:12Z","failure_code":"16","failure_reason":"NO_ANSWER","hangup_cause":"NO_ANSWER","hangup_cause_code":4100,"hangup_cause_name":"No Answer","hangup_disposition":"send_cancel","hangup_source":"Callee","id":18000001,"jitter":0,"mos":0,"network_addr":"10.0.0.1","origination_region":"mumbai","packet_loss":0,"progress_time":"2026-03-25T09:30:00Z","region":"ap-south-1","ring_time":12,"sip_call_id":"99887766-5544-3322-1100-aabbccddeeff","sip_user_agent":"Vobiz","start_time":"2026-03-25T09:30:00Z","streaming_cost":0,"terminated_to":null,"total_cost":0,"trunk_id":null,"updated_at":"2026-03-25T09:30:12Z","uuid":"11223344-5566-7788-99aa-bbccddeeff00"}],"pagination":{"page":1,"per_page":20,"total":4500,"pages":225,"has_next":true,"has_prev":false},"success":true,"summary":{"answerRate":48.2,"answeredCalls":2171,"avgCallDuration":"28s","last_call_at":"2026-03-25T10:00:00Z","totalCalls":4500,"total_billable_seconds":61211,"total_cost":1564.51,"total_duration_seconds":118234}},"examples":{"Example":{"title":"Example","value":{"account_id":"MA_XXXXXXXX","count":2,"data":[{"account_id":"MA_XXXXXXXX","answer_time":"2026-03-25T10:00:01Z","billsec":42,"bridge_uuid":"aabbccdd-1234-5678-90ab-cdef12345678","call_direction":"outbound","caller_id_name":"John Doe","caller_id_number":"+919876543210","campaign_id":null,"carrier_ip":"10.0.0.1","codec":"PCMU","context":"voice-api","cost":0.45,"created_at":"2026-03-25T10:00:42Z","currency":"INR","customer_endpoint":null,"destination_number":"+918012345678","duration":47,"end_time":"2026-03-25T10:00:42Z","failure_code":null,"failure_reason":null,"hangup_cause":"NORMAL_CLEARING","hangup_cause_code":4000,"hangup_cause_name":"Normal Hangup","hangup_disposition":"send_bye","hangup_source":"Caller","id":18000000,"jitter":0.2,"mos":4.5,"network_addr":"10.0.0.1","origination_region":"mumbai","packet_loss":0.1,"progress_time":"2026-03-25T10:00:00Z","region":"ap-south-1","ring_time":5,"sip_call_id":"11223344-5566-7788-99aa-bbccddeeff00","sip_user_agent":"Vobiz","start_time":"2026-03-25T10:00:00Z","streaming_cost":0,"terminated_to":null,"total_cost":0.45,"trunk_id":null,"updated_at":"2026-03-25T10:00:42Z","uuid":"aabbccdd-1234-5678-90ab-cdef12345678"},{"account_id":"MA_XXXXXXXX","answer_time":null,"billsec":0,"bridge_uuid":null,"call_direction":"inbound","caller_id_name":"","caller_id_number":"+919876543210","campaign_id":null,"carrier_ip":null,"codec":"PCMU","context":"voice-api","cost":0,"created_at":"2026-03-25T09:30:12Z","currency":"INR","customer_endpoint":null,"destination_number":"+918012345678","duration":12,"end_time":"2026-03-25T09:30:12Z","failure_code":"16","failure_reason":"NO_ANSWER","hangup_cause":"NO_ANSWER","hangup_cause_code":4100,"hangup_cause_name":"No Answer","hangup_disposition":"send_cancel","hangup_source":"Callee","id":18000001,"jitter":0,"mos":0,"network_addr":"10.0.0.1","origination_region":"mumbai","packet_loss":0,"progress_time":"2026-03-25T09:30:00Z","region":"ap-south-1","ring_time":12,"sip_call_id":"99887766-5544-3322-1100-aabbccddeeff","sip_user_agent":"Vobiz","start_time":"2026-03-25T09:30:00Z","streaming_cost":0,"terminated_to":null,"total_cost":0,"trunk_id":null,"updated_at":"2026-03-25T09:30:12Z","uuid":"11223344-5566-7788-99aa-bbccddeeff00"}],"pagination":{"page":1,"per_page":20,"total":4500,"pages":225,"has_next":true,"has_prev":false},"success":true,"summary":{"answerRate":48.2,"answeredCalls":2171,"avgCallDuration":"28s","last_call_at":"2026-03-25T10:00:00Z","totalCalls":4500,"total_billable_seconds":61211,"total_cost":1564.51,"total_duration_seconds":118234}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"c50d337f-92a2-4e86-b2c1-8be733ff0e0b":{"AuthID":{"type":"apiKey","in":"header","name":"X-Auth-ID","description":"Your Vobiz account Auth ID","scopes":[],"schemeName":"AuthID"},"AuthToken":{"type":"apiKey","in":"header","name":"X-Auth-Token","description":"Your Vobiz account Auth Token","scopes":[],"schemeName":"AuthToken"}}},"servers":{"63df1293-34a2-4314-96e6-4cfcad0f4404":{"url":"https://api.vobiz.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Auth-ID","description":"Your Vobiz account Auth ID","scopes":[],"schemeName":"AuthID"},"schema":{"title":"X-Auth-ID","type":"string","description":"Your Vobiz account Auth ID","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AuthID","name":"X-Auth-ID"},{"scheme":{"type":"apiKey","in":"header","name":"X-Auth-Token","description":"Your Vobiz account Auth Token","scopes":[],"schemeName":"AuthToken"},"schema":{"title":"X-Auth-Token","type":"string","description":"Your Vobiz account Auth Token","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AuthToken","name":"X-Auth-Token"}],"title":"AuthID \u0026 AuthToken"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"vobizai","siteName":"Vobiz","title":"List CDRs - Vobiz","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T20:13:57.298Z","originalFileLocation":"cdr/list-cdrs.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieve paginated Vobiz call detail records with filters for date range, number, direction, and duration - the main endpoint for analytics and billing.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Vobiz\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List CDRs - Vobiz\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve paginated Vobiz call detail records with filters for date range, number, direction, and duration - the main endpoint for analytics and billing.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vobiz Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.vobiz.ai/docs/cdr/list-cdrs\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://vobizai.mintlify.site/docs/_mintlify/api/og/v2?division=Call+Detail+Records\u0026amp;title=List+CDRs\u0026amp;description=Retrieve+paginated+Vobiz+call+detail+records+with+filters+for+date+range%2C+number%2C+direction%2C+and+duration+-+the+main+endpoint+for+analytics+and+billing.\u0026amp;theme=d9cfb5a257c4db351c1c1eeb\u0026amp;signature=8bdaa9bea42cc4e300e4b284d910f62515939d0ce1368f3e0030c6765d34243d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List CDRs - Vobiz\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve paginated Vobiz call detail records with filters for date range, number, direction, and duration - the main endpoint for analytics and billing.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://vobizai.mintlify.site/docs/_mintlify/api/og/v2?division=Call+Detail+Records\u0026amp;title=List+CDRs\u0026amp;description=Retrieve+paginated+Vobiz+call+detail+records+with+filters+for+date+range%2C+number%2C+direction%2C+and+duration+-+the+main+endpoint+for+analytics+and+billing.\u0026amp;theme=d9cfb5a257c4db351c1c1eeb\u0026amp;signature=8bdaa9bea42cc4e300e4b284d910f62515939d0ce1368f3e0030c6765d34243d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Vobiz\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E83C00\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"twitter:creator\" content=\"@Vobiz_Ai\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#E83C00\">\u003cmeta data-mint-head name=\"color-scheme\" content=\"dark light\">\u003cmeta data-mint-head name=\"author\" content=\"Vobiz\">\u003cmeta data-mint-head name=\"publisher\" content=\"Vobiz\">\u003cmeta data-mint-head name=\"copyright\" content=\"Copyright 2025 Vobiz\">\u003cmeta data-mint-head name=\"reply-to\" content=\"support@vobiz.ai\">\u003cmeta data-mint-head name=\"format-detection\" content=\"telephone=no\">\u003cmeta data-mint-head name=\"referrer\" content=\"origin-when-cross-origin\">\u003cmeta data-mint-head name=\"rating\" content=\"general\">\u003cmeta data-mint-head name=\"language\" content=\"en\">\u003cmeta data-mint-head name=\"category\" content=\"Technology\">\u003cmeta data-mint-head name=\"coverage\" content=\"Worldwide\">\u003cmeta data-mint-head name=\"distribution\" content=\"global\">\u003cmeta data-mint-head name=\"target\" content=\"all\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.vobiz.ai/docs/cdr/list-cdrs\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/cdr/list-cdrs.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.vobiz.ai/#organization\",\"name\":\"Vobiz\",\"url\":\"https://www.vobiz.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/vobizai/cPP2drhQ7lKsmogc/logo/light.svg?fit=max\u0026auto=format\u0026n=cPP2drhQ7lKsmogc\u0026q=85\u0026s=8e1f6273f626f638f46d6df526d4775c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.vobiz.ai/docs#website\",\"name\":\"Vobiz\",\"url\":\"https://www.vobiz.ai/docs\",\"publisher\":{\"@id\":\"https://www.vobiz.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.vobiz.ai/docs/cdr/list-cdrs#webpage\",\"url\":\"https://www.vobiz.ai/docs/cdr/list-cdrs\",\"name\":\"List CDRs\",\"description\":\"Retrieve paginated Vobiz call detail records with filters for date range, number, direction, and duration - the main endpoint for analytics and billing.\",\"dateModified\":\"2026-11-18T20:13:57.298Z\",\"isPartOf\":{\"@id\":\"https://www.vobiz.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.vobiz.ai/docs/cdr/list-cdrs#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.vobiz.ai/docs/cdr/list-cdrs#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Call Detail Records\",\"item\":\"https://www.vobiz.ai/docs/cdr\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List CDRs\",\"item\":\"https://www.vobiz.ai/docs/cdr/list-cdrs\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.vobiz.ai/docs/cdr/list-cdrs#apireference\",\"headline\":\"List CDRs\",\"name\":\"List CDRs\",\"description\":\"Retrieve paginated Vobiz call detail records with filters for date range, number, direction, and duration - the main endpoint for analytics and billing.\",\"url\":\"https://www.vobiz.ai/docs/cdr/list-cdrs\",\"mainEntityOfPage\":{\"@id\":\"https://www.vobiz.ai/docs/cdr/list-cdrs#webpage\"},\"dateModified\":\"2026-11-18T20:13:57.298Z\",\"keywords\":\"list CDRs Vobiz, call detail records API, CDR pagination, filter CDRs date range, from_number to_number filter, min_duration filter, call_direction filter, filter CDR bridge_uuid, filter CDR sip_call_id, hangup_cause filter, hangup_disposition filter, context filter, campaign_id filter, CDR search filter, Vobiz CDR list, call logs API, telephony CDR, CDR filter API, call history API, CDR inbound outbound filter, CDR billing review, call detail API\",\"publisher\":{\"@id\":\"https://www.vobiz.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://www.vobiz.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Vobiz\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Vobiz\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/cdr/list-cdrs.md","siteName":"Vobiz","nav":{"global":{"anchors":[{"anchor":"API Status","icon":"signal","href":"https://status.vobiz.ai"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","anchors":[{"anchor":"Regular APIs","icon":"database","groups":[{"group":"Account","boost":3,"icon":"circle-user","root":{"title":"Vobiz Account API: Balance \u0026 Concurrency","sidebarTitle":"Account","href":"/account"},"pages":[{"title":"The Account Object","href":"/account/account-object"},{"openapi":"GET /api/v1/auth/me","title":"Retrieve Account Details","href":"/account/retrieve-account"},{"openapi":"GET /api/v1/Account/{auth_id}/balance/{currency}","title":"Balance","href":"/account/balance"},{"openapi":"GET /api/v1/Account/{auth_id}/transactions","title":"Transactions","href":"/account/transactions"},{"openapi":"GET /api/v1/Account/{auth_id}/concurrency","title":"Get Account Concurrency — Live Call Capacity","sidebarTitle":"Concurrency","href":"/account/concurrency"},{"openapi":"GET /api/v1/accounts/{auth_id}/channel-pricing-preview","title":"Preview CPS and concurrency pricing","sidebarTitle":"Preview capacity pricing","href":"/account/channel-pricing-preview"},{"openapi":"POST /api/v1/accounts/{auth_id}/channel-subscriptions","title":"Purchase CPS or concurrency capacity","sidebarTitle":"Purchase capacity","href":"/account/channel-subscriptions"},{"title":"NDNC Webhook","sidebarTitle":"NDNC Webhook","href":"/account/ndnc-webhook"}]},{"group":"Sub-Accounts","icon":"sitemap","root":{"title":"Vobiz Sub-Accounts API: Multi-Tenant Accounts","sidebarTitle":"Sub-Accounts","href":"/sub-accounts"},"pages":[{"title":"Sub-Account Onboarding Flow","sidebarTitle":"Onboarding Flow","href":"/sub-accounts/onboarding-flow"},{"title":"The Subaccount Object","sidebarTitle":"Subaccount Object","href":"/sub-accounts/subaccount-object"},{"openapi":"POST /api/v1/accounts/{auth_id}/sub-accounts/","title":"Create a Subaccount","sidebarTitle":"Create Subaccount","href":"/sub-accounts/create-subaccount"},{"openapi":"GET /api/v1/accounts/{auth_id}/sub-accounts/{sub_auth_id}","title":"Retrieve a Subaccount","sidebarTitle":"Retrieve Subaccount","href":"/sub-accounts/retrieve-subaccount"},{"openapi":"PUT /api/v1/accounts/{auth_id}/sub-accounts/{sub_auth_id}","title":"Update a Subaccount","sidebarTitle":"Update Subaccount","href":"/sub-accounts/update-subaccount"},{"openapi":"DELETE /api/v1/accounts/{auth_id}/sub-accounts/{sub_auth_id}","title":"Delete a Subaccount","sidebarTitle":"Delete Subaccount","href":"/sub-accounts/delete-subaccount"},{"openapi":"GET /api/v1/accounts/{auth_id}/sub-accounts/","title":"List All Subaccounts","sidebarTitle":"List Subaccounts","href":"/sub-accounts/list-all-subaccounts"},{"openapi":"POST /api/v1/account/{auth_id}/numbers/{e164}/assign-subaccount","title":"Assign DID to Sub-Account","sidebarTitle":"Assign to Sub-Account","href":"/account-phone-number/assign-subaccount"},{"openapi":"DELETE /api/v1/account/{auth_id}/numbers/{e164}/assign-subaccount","title":"Unassign DID (15-Day Cool-Off)","sidebarTitle":"Unassign from Sub-Account","href":"/account-phone-number/unassign-subaccount"},{"group":"KYC","icon":"id-card","pages":[{"title":"Sub-Account KYC","sidebarTitle":"Overview","href":"/sub-accounts/kyc/overview"},{"openapi":"GET /api/v1/sub-accounts/{sub_auth_id}/kyc/status","title":"Get KYC Status","sidebarTitle":"KYC Status","href":"/sub-accounts/kyc/kyc-status"},{"openapi":"POST /api/v1/sub-accounts/{sub_auth_id}/kyc-sessions","title":"Initialize KYC","sidebarTitle":"Initialize KYC","href":"/sub-accounts/kyc/kyc-session"},{"title":"KYC Email Flow with Webhook","sidebarTitle":"Email Flow \u0026 Webhook","href":"/sub-accounts/kyc/email-flow-webhook"},{"title":"KYC Redirect Flow with Webhook","sidebarTitle":"Redirect Flow \u0026 Webhook","href":"/sub-accounts/kyc/redirect-flow-webhook"},{"title":"KYC Test Mode","sidebarTitle":"Test Mode","href":"/sub-accounts/kyc/test-mode"}]}]},{"group":"Phone Numbers","icon":"phone","root":{"title":"Vobiz Phone Numbers API: Buy \u0026 Manage DIDs","sidebarTitle":"Phone Numbers","href":"/account-phone-number"},"pages":[{"title":"The PhoneNumber Object","sidebarTitle":"PhoneNumber Object","href":"/account-phone-number/account-phone-number-object"},{"openapi":"GET /api/v1/Account/{auth_id}/numbers","title":"List Account Phone Numbers","href":"/account-phone-number/list-account-phone-numbers"},{"title":"List Inventory Numbers","sidebarTitle":"List Inventory","openapi":"GET /api/v1/Account/{auth_id}/inventory/numbers","href":"/account-phone-number/list-inventory-numbers"},{"title":"Purchase from Inventory","sidebarTitle":"Purchase Number","openapi":"POST /api/v1/Account/{auth_id}/numbers/purchase-from-inventory","href":"/account-phone-number/purchase-from-inventory"},{"openapi":"DELETE /api/v1/Account/{auth_id}/numbers/{e164}","title":"Release a Phone Number","href":"/account-phone-number/unrent-number"},{"openapi":"POST /api/v1/account/{account_id}/numbers/{e164}/cancel-release","title":"Cancel a Number Release","sidebarTitle":"Cancel Release","href":"/account-phone-number/cancel-release"},{"openapi":"GET /api/v1/account/{auth_id}/numbers/{e164}/health","title":"Get Number Health Dashboard","sidebarTitle":"Number Health","href":"/account-phone-number/get-number-health"}]},{"group":"Recordings","icon":"circle-dot","root":{"title":"Vobiz Recordings API: Call \u0026 Conference Recordings","sidebarTitle":"Recording","href":"/recording"},"pages":[{"title":"The Recording Object","href":"/recording/recording-object"},{"openapi":"GET /api/v1/Account/{auth_id}/Recording/{recording_id}/","title":"Retrieve a Recording","href":"/recording/retrieve-recording"},{"openapi":"GET /api/v1/Account/{auth_id}/Recording/","title":"List All Recordings","href":"/recording/list-all-recordings"},{"title":"Download a Recording","href":"/recording/download-recording"},{"openapi":"POST /api/v1/Account/{auth_id}/export/recording/","title":"Export Historical Recordings","sidebarTitle":"Export Recordings","href":"/recording/export-historical-recordings"}]},{"group":"Call Detail Records","icon":"list-ul","root":{"title":"Vobiz Call Detail Records (CDR) API","sidebarTitle":"Call Detail Records","description":"Query, filter, and export Vobiz CDRs with per-call billing data, MOS scores, jitter, and hangup attribution - for reconciliation and TRAI reporting.","href":"/cdr"},"pages":[{"title":"List CDRs","openapi":"GET /api/v1/Account/{auth_id}/cdr","href":"/cdr/list-cdrs"},{"title":"Get Single CDR","openapi":"GET /api/v1/Account/{auth_id}/cdr/{call_id}","description":"Retrieve the full call detail record for one call by its call_id - duration, disposition, caller ID, timestamps, and billing data for that voice session.","href":"/cdr/get-cdr"},{"title":"Search CDRs","openapi":"GET /api/v1/Account/{auth_id}/cdr/search","href":"/cdr/search-cdrs"},{"title":"Recent CDRs","openapi":"GET /api/v1/Account/{auth_id}/cdr/recent","href":"/cdr/recent-cdrs"},{"title":"Export CDRs as CSV","openapi":"GET /api/v1/Account/{auth_id}/cdr/export","href":"/cdr/export-cdrs"}]}]},{"anchor":"SIP Trunking","icon":"network-wired","pages":[{"title":"SIP Trunking","href":"/trunks"}]},{"anchor":"Voice \u0026 XML","icon":"microphone","pages":[{"title":"Voice \u0026 XML","href":"/applications"}]},{"anchor":"SMS \u0026 RCS","icon":"comment-sms","pages":[{"title":"SMS \u0026 RCS","href":"/sms/overview"}]},{"anchor":"WhatsApp","icon":"comment-dots","pages":[{"title":"WhatsApp","href":"/whatsapp/getting-started/introduction"}]},{"anchor":"Partner API","icon":"handshake","pages":[{"title":"Partner API","href":"/partner"}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations"}]},{"tab":"Examples \u0026 Tutorials","pages":[{"title":"Examples \u0026 Tutorials","href":"/guides/ai-voice-agent"}]},{"tab":"Blogs","pages":[{"title":"Blogs","href":"/blogs"}]}]},"basePath":"","title":"List CDRs - Vobiz","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-Ku9dSkH0.js","snippetPresets-Cjez4eet.js","utils-BqNa-fnS.js","style-to-object-BY3JEAdk.js","utils-DiE92JCe.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-Bi0DpqVf.js","conditional-requirements-CFM0id0Q.js","cloneDeep-C6xnxscF.js","_Uint8Array-B7g0OYAt.js","isObject-FP1Yky1u.js","Page--B9YZ09u.js","CodeSnippet-CTZvgJfu.js","DynamicMarkdown-CsgNpZb1.js","SectionHeading-C3K437Dy.js","icon-DlxjjqnB.js","ApiExamples-Bf8Ecb5t.js","usePlaygroundInputsStore-BA942cq6.js","shallow-D0sePNkF.js","isEqual-CnnQO8sL.js","CodeSnippets-BTANoy1T.js","getApiPlaygroundDisplay-BK2o1XYu.js","MethodPill-Cr7Ib9nN.js","getPastedJson-DXo3wtHt.js","Check2Icon-ChEI-f_B.js","axios-CsQoIw0U.js","Markdown-CH4mv0N8.js","AssistantPageLink-BHjmqccN.js","dist-DYCPzQwJ.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}