---
title: "Number Masking status API"
method: POST
path: "receive-masked-call-report"
tags: ["channels", "voice", "number-masking", "number-masking-events"]
---

# Number Masking status API

`POST receive-masked-call-report` (webhook)

After a call to the Number Masking number has finished, the Infobip platform generates a request to your **statusUrl** 
set up in the Number Masking configuration. This request contains report details of the call. We also provide the **correlationID** and 
**nmCorrelationID** to be used as identifiers for this call request.

In return from your platform, the Infobip platform expects a confirmation that the request has been received successfully.

## Headers

- `Authorization` string

## Payload

- 322179e48f777ec7fa4be8d16ebc634ba865098b0ae9d513535e196958077f6cStatusRequest: Status request.
  - `action` string: Requested action (dial, audio, captureDtmf).
  - `from` string: Caller phone number.
  - `to` string: Called phone number.
  - `transferTo` string: Called party phone number that the call is transferred to.
  - `duration` integer: Duration of the outbound call shown in seconds
  - `status` string: Call status which can be: answered, busy, no answer, failed or congestion
  - `nmCorrelationId` string: Unique identifier for correlation with inbound call, available in Callback and Status requests.
  - `fileID` string: Identifier of the file played to the caller.
  - `fileUrl` string: The URL of the file played to the caller.
  - `ringingTime` string: Date and time when ringing started.
  - `answeredTime` string: Date and time when the call was answered.
  - `correlationId` string: Unique identifier of the call record, available for both Callback and Status requests.
  - `inboundDuration` integer: Duration of the inbound call shown in seconds.
  - `calculatedDuration` integer: The duration of the outbound part of the number masking session, where the voice billing model (1/1, 15/15,...) has been applied to the calculatedDuration.
  - `pricePerSecond` number, double: This is the price per second for the outbound part of the number masking session, with the price being expressed in cents per second.
  - `currency` string: The currency in which the price is expressed.
  - `recordingFileId` string: ID of a recording file of a call.
  - `recordCalleeAnnouncement` boolean: Flag that indicates if callee announcement is included in recording file.
  - `recordingStatus` 'HOSTED' | 'SFTP' | 'FAILED': Recording status provided if recording was attempted.
  - `machineDetectionResult` 'HUMAN' | 'MACHINE': Result of Answering Machine Detection. Possible values are `HUMAN` and `MACHINE`.
  - `clientReferenceId` string: Client-defined ID of a valid file name. Used to correlate a call with this reference. If recording is enabled and files are stored in the SFTP server, that ID will be used as a file name instead.

## Acknowledgement `200`

A successful response is represented by an HTTP status code 200 OK from the Client’s platform.

- 287f18f04e9f129a7bc94ed3ae48e2480e2673b8fdf041ab5125fde9674634b8StatusResponse

---

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