> ## Documentation Index > Fetch the complete documentation index at: https://docs.wavix.com/llms.txt > Use this file to discover all available pages before exploring further. # List CDRs > Returns a paginated list of call detail records for the authenticated account, within the requested date range. ## OpenAPI ````yaml https://wavix.github.io/wavix-openapi/wavix-api.yaml get /v1/cdrs openapi: 3.1.0 info: title: Wavix APIs description: >- Wavix provides robust APIs that let you integrate voice and text messaging features directly into your app. Send text, place calls, and access detailed reports programmatically. termsOfService: https://wavix.com/terms-and-conditions license: name: MIT identifier: MIT contact: name: Wavix url: https://wavix.com email: support@wavix.com version: '1.0' servers: - url: https://api.wavix.com description: https://api.wavix.com variables: {} security: - bearerAuth: [] tags: - name: SIP trunks description: SIP trunks - name: Buy description: Numbers - name: Cart description: Numbers - name: My numbers description: Numbers - name: Billing description: Billing, transactions, and invoices - name: Profile description: Account profile and customer information - name: CDRs description: Call detail records and call history - name: Speech Analytics description: Call transcription and speech analytics - name: SMS and MMS description: Messaging - name: Number Validator description: Phone number validation - name: Link shortener description: Short link and click metrics - name: 2FA description: Two-factor authentication - name: 10DLC description: 10DLC Campaigns and Brands - name: API Keys description: API key management - name: Call webhooks description: Webhook configuration for call events - name: Call control description: Programmable Voice - name: Call streaming description: Real-time call audio streaming over WebSocket - name: Call recording description: Call recording - name: Sub-accounts description: Sub-account management - name: Voice campaigns description: Outbound voice campaigns - name: Wavix Embeddable description: WebRTC embeddable widget paths: /v1/cdrs: get: tags: - CDRs summary: List CDRs description: >- Returns a paginated list of call detail records for the authenticated account, within the requested date range. operationId: cdrs_list parameters: - name: from in: query description: Start of the date range to query, in `YYYY-MM-DD` format. Inclusive. required: true style: form explode: true schema: type: string format: date example: '2023-01-01' - name: to in: query description: End of the date range to query, in `YYYY-MM-DD` format. Inclusive. required: true style: form explode: true schema: type: string format: date example: '2023-09-01' - name: type in: query description: >- Filters CDRs by call direction. One of `placed` (outbound calls dialed by the account) or `received` (inbound calls answered by the account). required: true style: form explode: true schema: type: string example: received - name: disposition in: query description: >- Filters CDRs by call disposition. One of `answered` (the called party answered), `busy` (the called party was busy), `rejected` (the call was declined), `failed` (the call could not be routed), or `all` (no disposition filter). style: form explode: true schema: allOf: - $ref: '#/components/schemas/CallDisposition' - name: from_search in: query description: >- Filters CDRs by originating phone number. Accepts a full or partial number. style: form explode: true schema: type: string example: '13524815863' - name: to_search in: query description: >- Filters CDRs by destination phone number. Accepts a full or partial number. style: form explode: true schema: type: string example: '12565378257' - name: sip_trunk in: query description: Filters outbound CDRs by SIP trunk login. Ignored for inbound calls. style: form explode: true schema: type: string example: '12321' - name: uuid in: query description: Filters CDRs by the unique call ID. style: form explode: true schema: type: string example: 99df5ffd-962a-410f-bcce-d08f1f7f328c - name: page in: query description: Page number to retrieve. Default `1`. style: form explode: true schema: type: integer format: int32 example: 1 - name: per_page in: query description: Number of records to return per page. Default `25`. style: form explode: true schema: type: integer format: int32 default: 25 example: 25 responses: '200': description: Returns a paginated list of CDRs. headers: {} content: application/json: schema: allOf: - $ref: '#/components/schemas/CDRListResponse' examples: success: summary: Successful response value: items: - date: '2023-08-21T06:43:36.000Z' from: '14302287001' to: '33170363950' disposition: answered duration: 6 destination: France per_minute: '0.027' charge: '0.822' sip_trunk: '32882' forward_fee: '0.0' uuid: 99df5ffd-962a-410f-bcce-d08f1f7f328c call_id: 99df5ffd-962a-410f-bcce-d08f1f7f328c parent_uuid: 99df5ffd-962a-410f-bcce-d08f1f7f328c answered_by: human pagination: current_page: 2 per_page: 25 total: 101 total_pages: 5 '400': $ref: '#/components/responses/BadRequestErrorResponse' deprecated: false security: - bearerAuth: - calls:read components: schemas: CallDisposition: title: CallDisposition enum: - answered - noanswer - busy - failed - all type: string description: >- Final disposition of the call. One of `answered` (the called party answered), `noanswer` (no answer within the ring timeout), `busy` (the called party was busy), `failed` (the call could not be routed), or `all` (matches any disposition when used as a filter). CDRListResponse: title: CDRListResponse required: - items - pagination type: object additionalProperties: false properties: items: type: array items: $ref: '#/components/schemas/CDR' description: List of CDRs pagination: $ref: '#/components/schemas/Pagination' CDR: title: CDR description: Call detail record (CDR) for an individual call. required: - date - from - to - disposition - duration - destination - per_minute - charge - uuid - call_id type: object additionalProperties: false properties: date: type: string format: date-time description: Date and time of the call in ISO 8601 format. example: '2023-08-21T06:43:36.000Z' from: type: string description: Originating phone number (ANI). example: '14302287001' to: type: string description: Destination phone number (DNIS). example: '33170363950' disposition: $ref: '#/components/schemas/CallDisposition' duration: type: integer format: int32 description: Call duration in seconds. example: 6 destination: type: string description: |- Destination of the call. For outbound calls, contains the country name and, optionally, a mobile carrier or city name. For inbound calls, includes the SIP trunk name, SIP URI, or PSTN number the call is forwarded to. example: France per_minute: type: string description: Price per minute in USD. example: '0.027' charge: type: string description: Total charge for the call in USD. example: '0.822' sip_trunk: type: - string - 'null' description: System-generated SIP trunk login. For outbound calls only. example: '32882' forward_fee: type: string description: >- PSTN forwarding price in USD. For inbound calls only when forwarded to PSTN. example: '0.0' uuid: type: string deprecated: true description: Call ID. Deprecated — use `call_id` instead. example: 99df5ffd-962a-410f-bcce-d08f1f7f328c call_id: type: string description: Call ID. Alias of `uuid`. example: 99df5ffd-962a-410f-bcce-d08f1f7f328c parent_uuid: type: - string - 'null' deprecated: true description: Parent call ID. Deprecated — use `parent_call_id` instead. example: 99df5ffd-962a-410f-bcce-d08f1f7f328c parent_call_id: type: - string - 'null' description: Parent call ID. Alias of `parent_uuid`. example: 99df5ffd-962a-410f-bcce-d08f1f7f328c answered_by: type: - string - 'null' description: Who answered the call. Possible values are `human`, `machine`. example: human Pagination: title: Pagination required: - current_page - per_page - total - total_pages type: object additionalProperties: false properties: current_page: type: integer description: Current page number. format: int32 example: 2 per_page: type: integer description: Number of records per page. format: int32 example: 25 total: type: integer description: Total number of records. format: int32 example: 101 total_pages: type: integer description: Total number of pages. format: int32 example: 5 ValidationErrorResponse: title: ValidationErrorResponse type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false message: type: string description: >- Human-readable description naming the missing or invalid request parameter. example: Missing or invalid parameter responses: BadRequestErrorResponse: description: Request failed. Missing or invalid parameter headers: {} content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer description: > Wavix API key. Pass as `Authorization: Bearer `. Keys support per-resource scopes (none / read / write). See [Restricted keys and scopes](https://docs.wavix.com/api-reference/authentication#restricted-keys-and-scopes). ````