> ## 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 call recordings > Returns a paginated list of call recordings for the authenticated account, filtered by date range, number, call, or SIP trunk. ## OpenAPI ````yaml https://wavix.github.io/wavix-openapi/wavix-api.yaml get /v1/recordings 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/recordings: get: tags: - Call recording summary: List call recordings description: >- Returns a paginated list of call recordings for the authenticated account, filtered by date range, number, call, or SIP trunk. operationId: call_recording_list parameters: - name: from_date in: query description: Start of the date range to query, in `YYYY-MM-DD` format. Inclusive. required: false style: form explode: true schema: type: string format: date example: '2023-01-01' - name: to_date in: query description: End of the date range to query, in `YYYY-MM-DD` format. Inclusive. required: false style: form explode: true schema: type: string format: date example: '2023-12-31' - name: from in: query description: >- Filters recordings by originating phone number. Accepts a full or partial number. required: false style: form explode: true schema: type: string example: '123456' - name: to in: query description: >- Filters recordings by destination phone number. Accepts a full or partial number. required: false style: form explode: true schema: type: string example: '1987654321' - name: call_uuid in: query description: Filters recordings by the unique call ID. required: false style: form explode: true schema: type: string example: aa566501-c591-4a8b-b3b9-cc1295398b72 - name: sip_trunks in: query description: >- Filters recordings of outbound calls placed through the listed SIP trunk logins. required: false style: form explode: true schema: type: array items: type: string example: - '123' - '456' - 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 call recordings. headers: {} content: application/json: schema: $ref: '#/components/schemas/CallRecordingListResponse' examples: success: summary: Successful response value: recordings: - id: 123 created_at: '2023-06-15T10:30:00Z' duration: 120 from: '1234567890' to: '0987654321' call_uuid: aa566501-c591-4a8b-b3b9-cc1295398b72 url: https://api.wavix.com/v1/recordings/uuid invalid: dids: - invalid_did_1 - invalid_did_2 sip_trunks: - invalid_trunk_1 - invalid_trunk_2 pagination: current_page: 2 per_page: 25 total: 101 total_pages: 5 '401': $ref: '#/components/responses/UnauthorizedErrorResponse' '403': $ref: '#/components/responses/ForbiddenErrorResponse' deprecated: false security: - bearerAuth: - recordings:read components: schemas: CallRecordingListResponse: type: object additionalProperties: false properties: recordings: type: array description: Call recordings that match the request. items: $ref: '#/components/schemas/Recording' invalid: $ref: '#/components/schemas/InvalidRecording' pagination: $ref: '#/components/schemas/Pagination' Recording: title: Recording required: - id - created_at - duration - from - to - call_uuid - url type: object additionalProperties: false properties: id: type: integer format: int32 description: Recording ID. example: 123 created_at: type: string format: date-time description: Date and time when the recording was created in ISO 8601 format. example: '2023-06-15T10:30:00Z' duration: type: integer format: int32 description: Recording duration in seconds. example: 120 from: type: string description: Originating phone number. example: '1234567890' to: type: string description: Destination phone number. example: '0987654321' call_uuid: type: string description: Call ID. example: aa566501-c591-4a8b-b3b9-cc1295398b72 url: type: string description: Recording file URL. example: https://api.wavix.com/v1/recordings/uuid description: A call recording response InvalidRecording: title: InvalidRecording type: object additionalProperties: false properties: dids: type: array items: type: string description: Phone number IDs that did not match any recording. example: - invalid_did_1 - invalid_did_2 sip_trunks: type: array items: type: string description: SIP trunk IDs that did not match any recording. example: - invalid_trunk_1 - invalid_trunk_2 description: An invalid recording filter response 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 UnauthorizedErrorResponse: title: UnauthorizedErrorResponse type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false error: type: boolean description: >- Indicates that the response represents an error. Always `true` for this error. example: true message: type: string description: >- Human-readable description stating that authentication is missing or invalid. example: Unauthorized ForbiddenErrorResponse: title: ForbiddenErrorResponse 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 of why access is forbidden. example: The service is not provisioned for your account. responses: UnauthorizedErrorResponse: description: Unauthorized headers: {} content: application/json: schema: $ref: '#/components/schemas/UnauthorizedErrorResponse' ForbiddenErrorResponse: description: Request failed. The feature is disabled for your account. headers: {} content: application/json: schema: $ref: '#/components/schemas/ForbiddenErrorResponse' 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). ````