Query billing usage data

Start the process of aggregating billing-grade financial cost data for your Infobip traffic. The results are delivered once via POST to the callbackURL provided in the request. Make sure the URL is reachable before submitting. See Receive billing usage result for the webhook payload structure.

post/billing/1/usage/query

Request

Base URL
https://api.infobip.com (the document declares no server; this is the origin it was published from)
Auth
- OAuth 2
  Client credentials
  Token URL: https://api.infobip.com/auth/1/oauth2/token
- or API key in header Authorization
- or API key in header Authorization
- or HTTP basic

Request body

callbackUrlstring required

Target URL to receive the query processing results. For schema details, see: Receive billing usage result.

Example request

{
  "request": {
    "filterBy": {
      "dateInterval": {
        "sentSince": "2026-03-01",
        "sentUntil": "2026-04-01"
      },
      "accountKeys": [
        "account_key_1",
        "account_key_2"
      ],
      "countryCodes": [
        "US",
        "DE",
        "IN"
      ],
      "platforms": [
        {
          "applicationId": "your_application_id",
          "entityId": "your_entity_id"
        }
      ],
      "trafficTypes": [
        "UTILITY",
        "MARKETING"
      ],
      "senders": [
        "mySender",
        "12345",
        "15551234567",
        "jane.smith@somecompany.com"
      ],
      "senderTypes": [
        "ALPHANUMERIC",
        "SHORT_CODE",
        "VIRTUAL_LONG_NUMBER",
        "DOMAIN"
      ],
      "campaignReferenceIds": [
        "summer-sale",
        "bf2026"
      ],
      "campaignIds": [
        12354646546,
        45534466546,
        754564654689
      ],
      "templateIds": [
        "5653923468715475",
        "5253923468715475"
      ]
    }
  }
}

Response

Data querying process is started.

requestIdstring required

The identifier of the submitted request.

Changes

No recorded changes to this operation across all 1 revision of this API.