---
title: "Get recordings"
method: GET
path: "/markuplanguage/1/recordings"
tags: ["channels", "voice", "calls-markup-language", "calls-markup-language-recordings"]
---

# Get recordings

`GET /markuplanguage/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/markuplanguage/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

This method allows searching and filtering of Calls Markup Language recordings based on various properties.

## Query parameters

- `sortBy` 'MARKUP_RECORDING_ID' | 'CALL_ID' | 'DIALOG_ID' | 'START_TIME' | 'END_TIME'
- `sortDirection` 'ASC' | 'DESC'
- `callId` string
- `dialogId` string
- `markupRecordingId` string
- `markupUrl` 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

- Aa157138bc28697f89db8325cc3d3ce20c0f3c72c30b6831a5435f3f2d211cfeCallsMarkupLanguageRecordingPage
  - `results` 6ee61eb40f9e4619d309dfe8df9b479488b43bcde7df95f6a044b2e14abf591eMarkupLanguageRecordingApiResponse[]: The list of the results for this page.
    - `application` 287f18f04e9f129a7bc94ed3ae48e2480e2673b8fdf041ab5125fde9674634b8CallsMarkupLanguageApplication, required: Application data for the recording.
      - `type` 'CALLS_MARKUP_LANGUAGE': Application type.
      - `markupRecordingId` string: Markup language recording identifier.
      - `callId` string: Call identifier.
      - `dialogId` string: Dialog identifier.
      - `markupUrl` string: Markup URL used to initiate the call.
      - `startTime` string, date-time: Start time of the call.
      - `endTime` string, date-time: End time of the call.
    - `recording` 6ee61eb40f9e4619d309dfe8df9b479488b43bcde7df95f6a044b2e14abf591eRecordingMetadata, required: Recording metadata
      - `composedFiles` 6ee61eb40f9e4619d309dfe8df9b479488b43bcde7df95f6a044b2e14abf591eRecordedFile[]: Composed recording files.
        - `id` string: File ID.
        - `name` string: File name.
        - `fileFormat` 'MP3' | 'WAV' | 'MP4': File format.
        - `size` integer: File size in bytes.
        - `startTime` string, date-time: Date and time when the recording started.
        - `endTime` string, date-time: Date and time when the recording ended.
        - `creationTime` string, date-time: File creation time.
        - `duration` integer: File duration in seconds.
        - `location` 'UPLOADING' | 'UPLOADED' | 'HOSTED': Location of recording file after processing.
        - `customData` object: Client-defined data.
      - `callRecordings` 6ee61eb40f9e4619d309dfe8df9b479488b43bcde7df95f6a044b2e14abf591eCallRecording[]: Call recording data.
        - `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` string: Status of call recording.
        - `reason` string: Reason for recording failure.
        - `files` 6ee61eb40f9e4619d309dfe8df9b479488b43bcde7df95f6a044b2e14abf591eRecordedFile[]: Recording files.
          - `id` string: File ID.
          - `name` string: File name.
          - `fileFormat` 'MP3' | 'WAV' | 'MP4': File format.
          - `size` integer: File size in bytes.
          - `startTime` string, date-time: Date and time when the recording started.
          - `endTime` string, date-time: Date and time when the recording ended.
          - `creationTime` string, date-time: File creation time.
          - `duration` integer: File duration in seconds.
          - `location` 'UPLOADING' | 'UPLOADED' | 'HOSTED': Location of recording file after processing.
          - `customData` object: Client-defined data.
  - `paging` 287f18f04e9f129a7bc94ed3ae48e2480e2673b8fdf041ab5125fde9674634b8PageInfo: 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)