---
title: "Get recordings"
method: GET
path: "/callrouting/1/recordings"
tags: ["channels", "voice", "routing", "call-routing-recordings"]
---

# Get recordings

`GET /callrouting/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/callrouting/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 based on various recording data properties.

## Query parameters

- `sortBy` 'ENDPOINT_TYPE' | 'ROUTE_ID' | 'CORRELATION_ID' | 'START_TIME' | 'END_TIME'
- `sortDirection` 'ASC' | 'DESC'
- `endpointType` string
- `phoneNumber` string
- `sipTrunkId` string
- `sipUsername` string
- `webrtcIdentity` string
- `routeId` string
- `routeName` string
- `correlationId` 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

- Aa157138bc28697f89db8325cc3d3ce20c0f3c72c30b6831a5435f3f2d211cfeCallRoutingRecordingPage
  - `results` 6ee61eb40f9e4619d309dfe8df9b479488b43bcde7df95f6a044b2e14abf591eCallRoutingRecordingApiResponse[]: The list of the results for this page.
    - `application` 287f18f04e9f129a7bc94ed3ae48e2480e2673b8fdf041ab5125fde9674634b8CallRoutingApplication, required: Application data for the recording.
      - `type` 'CALL_ROUTING': Application type.
      - `routeId` string: Route identifier.
      - `routeName` string: Route name.
      - `correlationId` string, required: Unique identifier for a call routing recording 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)