---
title: "Get call link recordings"
method: GET
path: "/call-link/1/recordings"
tags: ["channels", "webrtc-calls", "call-link", "call-link-recordings"]
---

# Get call link recordings

`GET /call-link/1/recordings`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/call-link/1/recordings`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Use this method to filter and retrieve call link recordings.

## Query parameters

- `sortBy` 'DESTINATION_DATA' | 'DESTINATION_TYPE' | 'CALL_LINK_CONFIG_ID' | 'CALL_LINK_ID' | 'START_TIME_BEFORE' | 'START_TIME_AFTER'
- `sortDirection` 'ASC' | 'DESC'
- `destinationData` string
- `destinationType` 'ROOM' | 'WEBRTC' | 'PHONE': Destination type.
- `callLinkConfigId` string
- `callLinkId` string
- `startTimeAfter` string, date-time
- `startTimeBefore` string, date-time
- `location` 'SAO_PAULO' | 'BOGOTA' | 'FRANKFURT' | 'JOHANNESBURG' | 'JOHANNESBURG_1' | 'NEW_YORK' | 'PORTLAND' | 'MOSCOW' | 'SINGAPORE' | 'ISTANBUL' | 'KUALA_LUMPUR' | 'JAKARTA' | 'MUMBAI' | 'HONG_KONG_1' | 'HONG_KONG' | 'RIYADH' | 'CHENNAI'
- `page` integer
- `size` integer

## Response `200`

Success.

- D32f709b8e696d073f5212b1e1d90721a8fd1118bf2c8abce078bf2baf7d1707RecordingPage
  - `results` 73e6f414ccb2e1e41274c061b50cf5765f69b642a3e0cca54b0248eb3baf086dRecordingResponse[]: The list of the results for this page.
    - `application` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14CallLinkRecordingApplication, required: Recording application metadata
      - `type` 'CALL_LINK', required
    - `recording` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14Recording, required: Recording metadata.
      - `composedFiles` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14RecordingFile[]: List of composed files.
        - `id` string: File identifier.
        - `name` string: File name.
        - `fileFormat` 'MP3' | 'WAV' | 'MP4': File format.
        - `size` integer: File size in bytes.
        - `startTime` string, date-time: Date and time in the UTC timezone when the recording started. Has the following format: `yyyy-MM-dd'T'HH:mm:ss.SSS+ZZZZ`.
        - `endTime` string, date-time: Date and time in the UTC timezone when the recording ended. Has the following format: `yyyy-MM-dd'T'HH:mm:ss.SSS+ZZZZ`.
        - `creationTime` string, date-time: Date and time in the UTC timezone when the recording file was created. Has the following format: `yyyy-MM-dd'T'HH:mm:ss.SSS+ZZZZ`.
        - `duration` integer: File duration in seconds.
        - `location` 'UPLOADING' | 'UPLOADED' | 'HOSTED': Location of recording file after processing.
        - `customData` object: Client-defined data.
      - `callRecordings` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14CallRecording[]: List of call recordings.
        - `callId` string: Call identifier.
        - `endpoint` string: Call endpoint. Represents a caller for the inbound calls and a callee for the outbound calls.
        - `direction` 'INBOUND' | 'OUTBOUND': Call direction.
        - `status` 'SUCCESSFUL' | 'PARTIALLY_FAILED' | 'FAILED': Status of call recording.
        - `reason` string: Reason for recording failure. Empty if call did not fail.
        - `files` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14RecordingFile[]: Recording files.
          - `id` string: File identifier.
          - `name` string: File name.
          - `fileFormat` 'MP3' | 'WAV' | 'MP4': File format.
          - `size` integer: File size in bytes.
          - `startTime` string, date-time: Date and time in the UTC timezone when the recording started. Has the following format: `yyyy-MM-dd'T'HH:mm:ss.SSS+ZZZZ`.
          - `endTime` string, date-time: Date and time in the UTC timezone when the recording ended. Has the following format: `yyyy-MM-dd'T'HH:mm:ss.SSS+ZZZZ`.
          - `creationTime` string, date-time: Date and time in the UTC timezone when the recording file was created. Has the following format: `yyyy-MM-dd'T'HH:mm:ss.SSS+ZZZZ`.
          - `duration` integer: File duration in seconds.
          - `location` 'UPLOADING' | 'UPLOADED' | 'HOSTED': Location of recording file after processing.
          - `customData` object: Client-defined data.
  - `paging` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14PageInfo: Contains information about the page.
    - `page` integer, required: Requested page number.
    - `size` integer, required: Requested page size.
    - `totalPages` integer, required: The total number of pages of the results matching the requested parameters.
    - `totalResults` integer, required: The total number of the results matching the requested parameters.

## Other responses

- `400`: Bad request.
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)