---
title: "Get dialog history"
method: GET
path: "/calls/1/dialogs/{dialogId}/history"
tags: ["channels", "voice", "calls", "dialog-calls", "dialog-management"]
---

# Get dialog history

`GET /calls/1/dialogs/{dialogId}/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/dialogs/{dialogId}/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 dialog history. Dialog history retention period is 5 days.

## Path parameters

- `dialogId` string, required

## Response `200`

Success

- 5fc49137a7b003ca1d8c4957601417b8ed884356b7fbc49afe416dd5c098a0bdDialogLogResponse
  - `dialogId` string: Unique dialog ID.
  - `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).
  - `state` 'CREATED' | 'PRE_ESTABLISHED' | 'ESTABLISHED' | 'FINISHED' | 'FAILED' | 'TRANSFERRING': Dialog state.
  - `startTime` string, date-time: Date and time for when the dialog has been created.
  - `establishTime` string, date-time: Date and time for when the dialog has been established.
  - `endTime` string, date-time: Date and time for when the dialog has been finished.
  - `parentCallId` string: Unique parent call ID.
  - `childCallId` string: Unique child call ID.
  - `duration` integer: Dialog duration in seconds.
  - `recording` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611DialogRecordingLog: Dialog recordings.
    - `composedFiles` A8c993b4bcabd2960dfaf3986394e0fe85cd1c09dc98b0a81b51403a00c8f97cPublicRecordingFile[]: File(s) with a recording of both dialog calls.
      - `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 individual dialog calls.
      - `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.
  - `hangupSource` 'API' | 'PARENT_ENDPOINT' | 'CHILD_ENDPOINT' | 'PLATFORM'

## 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)