---
title: "Get conference history"
method: GET
path: "/calls/1/conferences/{conferenceId}/history"
tags: ["channels", "voice", "calls", "conference-calls", "conference-management"]
---

# Get conference history

`GET /calls/1/conferences/{conferenceId}/history`

## 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/calls/1/conferences/{conferenceId}/history`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

Get a single conference history. Conference history retention period is 5 days.

## Path parameters

- `conferenceId` string, required

## Response `200`

Success

- 707907921d4508c2925eddc2449f10db322ecc083be424f87c50fe97ccd8be40ConferenceLogResponse
  - `conferenceId` string: Unique conference ID.
  - `name` string: Conference name, requested or autogenerated on creation.
  - `platform` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611Platform: Platform options. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).
    - `entityId` string: Required to use entity in a send request for outbound traffic. Returned in notification events. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).
    - `applicationId` string: Required for application use in a send request for outbound traffic. Returned in notification events. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).
  - `startTime` string, date-time: Date and time for when the conference has been created.
  - `endTime` string, date-time: Date and time for when the conference ended.
  - `duration` integer: Conference duration in seconds.
  - `sessions` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611ParticipantSession[]: List of participant sessions.
    - `callId` string: Unique call ID.
    - `joinTime` string, date-time: Date and time for when the participant joined the conference.
    - `leaveTime` string, date-time: Date and time for when the participant left the conference.
  - `recording` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611ConferenceRecordingLog: Conference recordings.
    - `composedFiles` A8c993b4bcabd2960dfaf3986394e0fe85cd1c09dc98b0a81b51403a00c8f97cPublicRecordingFile[]: File(s) with a recording of all conference participants.
      - `id` string: File ID.
      - `name` string, required: File name.
      - `fileFormat` 'MP3' | 'WAV' | 'MP4', required: File format.
      - `size` integer: File size in bytes.
      - `creationTime` string, date-time: File creation time.
      - `duration` integer: File duration in seconds.
      - `startTime` string, date-time: Date and time when the recording started.
      - `endTime` string, date-time: Date and time when the recording ended.
      - `location` 'SFTP' | 'HOSTED': Location of recording file after processing.
      - `sftpUploadStatus` 'UPLOADING' | 'UPLOADED' | 'FAILED': Indicates current status of the recording file being uploaded via SFTP.
      - `customData` object: Custom data.
    - `callRecordings` A8c993b4bcabd2960dfaf3986394e0fe85cd1c09dc98b0a81b51403a00c8f97cPublicCallRecording[]: File(s) with a recording of one conference participant.
      - `callId` string: Call ID.
      - `endpoint` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611CallEndpoint, required: Call endpoint. Represents a caller for the inbound calls and a callee for the outbound calls.
        - `type` 'PHONE' | 'SIP' | 'WEBRTC' | 'VIBER' | 'WHATSAPP' | 'WEBSOCKET'
      - `direction` 'INBOUND' | 'OUTBOUND': Call direction.
      - `files` A8c993b4bcabd2960dfaf3986394e0fe85cd1c09dc98b0a81b51403a00c8f97cPublicRecordingFile[]: Call recording files.
        - `id` string: File ID.
        - `name` string, required: File name.
        - `fileFormat` 'MP3' | 'WAV' | 'MP4', required: File format.
        - `size` integer: File size in bytes.
        - `creationTime` string, date-time: File creation time.
        - `duration` integer: File duration in seconds.
        - `startTime` string, date-time: Date and time when the recording started.
        - `endTime` string, date-time: Date and time when the recording ended.
        - `location` 'SFTP' | 'HOSTED': Location of recording file after processing.
        - `sftpUploadStatus` 'UPLOADING' | 'UPLOADED' | 'FAILED': Indicates current status of the recording file being uploaded via SFTP.
        - `customData` object: Custom data.
      - `status` 'SUCCESSFUL' | 'PARTIALLY_FAILED' | 'FAILED': Status of call recording.
      - `reason` string: Reason for recording failure.
      - `callsConfigurationId` string: Calls Configuration ID.
      - `platform` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611Platform: Platform options. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).
        - `entityId` string: Required to use entity in a send request for outbound traffic. Returned in notification events. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).
        - `applicationId` string: Required for application use in a send request for outbound traffic. Returned in notification events. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).
      - `startTime` string, date-time: Date and time when the (first) call recording started.
      - `endTime` string, date-time: Date and time when the (last) call recording ended.
  - `errorCode` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611ErrorCodeInfo: Reason why the call has finished.
    - `id` integer: Unique ErrorCode ID.
    - `name` string: Unique ErrorCode name in machine-readable format.
    - `description` string: ErrorCode description in human-readable format.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `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)