---
title: "Receive billing usage result"
method: POST
path: "receive-billing-usage-result"
tags: ["platform", "billing-usage-api"]
---

# Receive billing usage result

`POST receive-billing-usage-result` (webhook)

Receives data response requested by the [Query billing usage data](#platform/billing-usage-api/query-billing-usage) endpoint. This webhook is called once via POST when the query completes.

## Payload

- 99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2BillingUsageResult
  - `requestId` string, required: Identifier of the original request, returned by [Query billing usage data](#platform/billing-usage-api/query-billing-usage) endpoint.
  - `status` 'SUCCESS' | 'FAILED', required: Status of the request. If successful, the response will contain aggregated data. If failed, it will contain failure message.
  - `response` 99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2AggregateDataResponse
    - `requestedPeriod` 99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2DateTimeInterval, required
      - `sentSince` string, date-time, required: Start of the sent traffic date-time period (inclusive).
      - `sentUntil` string, date-time, required: End of the sent traffic date-time period (exclusive).
    - `totalRows` integer, required: Total number of data rows.
    - `columns` 99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2ColumnInfo[], required: List of columns available in the response data rows.
      - `columnName` string, required: Name of the column.
      - `columnDataType` 'STRING' | 'INTEGER' | 'NUMBER' | 'BOOLEAN' | 'DATE_TIME', required: Data type of the values related to a given column. The available data types are: * `STRING` - type used for string values. * `INTEGER` - type used for integral numbers. * `NUMBER` - type used for floating point numbers. * `BOOLEAN` - type used for boolean values. * `DATE_TIME` - type used to display date and time together (in UTC timezone, formatted as yyyy-MM-ddTHH:mm:ss).
    - `rows` array[], required: Array of data rows, where each row shows the aggregated data for one combination of the requested dimensions. Values map to the columns array by index. If a metric is not available for a given channel, the corresponding value is "N/A".
      - object[]: Values of a row, ordered as specified by columns property.
  - `failureMessage` string: Message describing the failure. Returned only if the request failed.
  - `metadata` 99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2BillingUsageMetadata: Additional billing data metadata included in the response.
    - `clientRequestedPeriod` 99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2DateTimeInterval, required
      - `sentSince` string, date-time, required: Start of the sent traffic date-time period (inclusive).
      - `sentUntil` string, date-time, required: End of the sent traffic date-time period (exclusive).
    - `billingPeriods` 99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2BillingUsageMetadataPeriod[], required: Metadata for each covered calendar month.
      - `month` string, required: Calendar month in yyyy-MM format.
      - `volumeFinalized` boolean, required: Indicates whether the billing data for this month has been fully processed and no further volume changes are expected.

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