---
title: "Recording status callback API"
method: POST
path: "send-recording-status-callback"
tags: ["channels", "voice", "calls-markup-language", "markup-language-instructions-async"]
---

# Recording status callback API

`POST send-recording-status-callback` (webhook)

When the Infobip platform finishes processing a recording requested by a Record instruction, it generates a request 
to the callback URL configured on Record or StartRecording instruction. The request carries the call context together with the 
recording status.

## Payload

- 60d0e6d5cbcf8382b5a6bad1f38781f71991c7ea63dad2e6ec22ddc8893af51cRecordingStatusCallbackRequest: Markup Language recording status callback request object. Sent to the callback URL configured on the Record or StartRecording instruction once the recording has been fully processed. Extends the instructions callback payload with the recorded file identifier and the final recording status.
  - `callId` string: Unique identifier of the call.
  - `from` string: The phone number of the caller in the [E.164](https://en.wikipedia.org/wiki/E.164) format.
  - `to` string: The phone number of the callee in the [E.164](https://en.wikipedia.org/wiki/E.164) format.
  - `direction` 'INBOUND' | 'OUTBOUND': The direction of the call. Possible values are: INBOUND, OUTBOUND.
  - `endpoint` 287f18f04e9f129a7bc94ed3ae48e2480e2673b8fdf041ab5125fde9674634b8CallbackEndpoint: Endpoint involved in the call delivered to the Markup Language callback.
    - `type` 'PHONE' | 'SIP' | 'WEBRTC' | 'VIBER' | 'WHATSAPP' | 'WEBSOCKET', required
  - `startTime` string, date-time: The timestamp when the call started, in ISO-8601 UTC format (yyyy-MM-dd'T'HH:mm:ss.SSSZ).
  - `recordingFileId` string: The unique identifier of the recording file.
  - `recordingStatus` 'in-progress' | 'completed': Recording status delivered with the record callback.

## Acknowledgement `200`

Your server returns this code if it accepts the callback.

---

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