> For the complete documentation index, see [llms.txt](https://docs.360dialog.com/partner/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.360dialog.com/partner/partner-hub/checking-usage-and-statistics.md).

# Insights

Track WhatsApp usage and costs for each client and phone number (channel) through the 360dialog Hub, the Partner API, or webhooks. Usage can be checked regardless of whether the account is on **Direct Payment** or **Partner Payment**. Final charges always come from Meta’s monthly invoice.

There are multiple ways to check it:&#x20;

* [View usage visually in the 360Dialog Hub](#view-usage-visually-in-the-360dialog-hub)
* [View usage across all clients in the Partner Hub](#view-usage-across-all-clients)
* [Get usage programmatically per channel via API](#get-usage-programmatically-per-channel-via-api)
* [Build your own counters from webhook events](#via-webhook)

{% hint style="warning" %}
Pricing is [message-based](https://docs.360dialog.com/partner/get-started/billing-and-invoicing-guide/conversations). All in-month usage data is an **estimate** and may slightly differ from the final invoice issued by Meta.
{% endhint %}

## View usage visually in the 360Dialog Hub

Clients and Partners can see a specific WABA usage in the Insights dashboard. To access it, click the specific WABA you want to use, then in the channel details, select Insights from the top menu.

### Messages Insights <a href="#messages-insights" id="messages-insights"></a>

View the message breakdown according to the selected date range.

There are three categories:

* **Messages**
* **Messages Breakdown**
* **Costs Breakdown**

**Messages**

It is possible to check the Total Messages coun&#x74;**,** how many were delivered, and the approximate costs.

<figure><img src="https://2248475362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuyAl2S0lSHJaNDXJHo7A%2Fuploads%2FUHCM2zCLapR6MZTOoN8V%2Fimage.png?alt=media&amp;token=220762a8-5d00-4a57-b56a-5ff559abe9d9" alt=""><figcaption></figcaption></figure>

**Messages Breakdown**

Total number of messages by category or country.

<figure><img src="https://2248475362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuyAl2S0lSHJaNDXJHo7A%2Fuploads%2FUrYktsBR1yrbOdSwtcRt%2Fimage.png?alt=media&amp;token=d597d42b-20ba-4052-8ff9-f096973b94af" alt=""><figcaption></figcaption></figure>

Using three dots, you can select the country or category and how to display the sum (total or overtime). An export option is also available.

<figure><img src="https://2248475362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuyAl2S0lSHJaNDXJHo7A%2Fuploads%2FgY5mSqLWZDA61CXj0L8I%2Fimage.png?alt=media&amp;token=6c2beac6-3c92-44fa-8dc8-8044681bc429" alt=""><figcaption></figcaption></figure>

**Costs Breakdown**

Total costs by category or country.

<figure><img src="https://2248475362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuyAl2S0lSHJaNDXJHo7A%2Fuploads%2FoOZ9PchBnueQg82Gen8a%2Fimage.png?alt=media&amp;token=617bf036-cade-4cd7-8992-faf0156090b1" alt=""><figcaption></figcaption></figure>

Using three dots, you can select the country or category and how to display the sum (total or overtime). An export option is also available.

<figure><img src="https://2248475362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuyAl2S0lSHJaNDXJHo7A%2Fuploads%2Ft7aoxlcCTWjq1EyADK5d%2Fimage.png?alt=media&amp;token=bc0d4b8a-4620-4aa8-86b1-34e8ed350e95" alt=""><figcaption></figcaption></figure>

**The precise amount due will be determined by Meta's invoice**

Please be aware that the Approximate Charges displayed in the 360Dialog Hub are financially binding in their totality. The precise amount due will be determined by Meta's invoice at the end of the month, which will serve as the authoritative record of charges

### Voice Calls Insights <a href="#voice-calls-insights" id="voice-calls-insights"></a>

View the call breakdown according to the selected date range.

There are two categories:

* **Voice Calls Breakdown**
* **Calls by Country**

**Voice Calls Breakdown**

Check the Total Calls count, approximate costs, and outbound and inbound calls.

<figure><img src="https://2248475362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuyAl2S0lSHJaNDXJHo7A%2Fuploads%2F4iTohuSkaDvhsAtMWMEx%2Fimage.png?alt=media&amp;token=d1efc2b3-3a88-4ac4-9bfb-4a6b0711fd4a" alt=""><figcaption></figcaption></figure>

**Calls by Country**

Total calls by country.

<figure><img src="https://2248475362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuyAl2S0lSHJaNDXJHo7A%2Fuploads%2FbPYBCPCmZoCaTcUp6hRL%2Fimage.png?alt=media&amp;token=64346da9-9630-4ba7-80f8-5a25f3712d9d" alt=""><figcaption></figcaption></figure>

Using three dots, the style can be changed. An export option is also available

<figure><img src="https://2248475362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuyAl2S0lSHJaNDXJHo7A%2Fuploads%2FuxVmIRJIOLoFhbVip17t%2Fimage.png?alt=media&amp;token=44f4183a-cb64-4631-a316-e9a92c060b04" alt=""><figcaption></figcaption></figure>

## View Usage Across All Clients

The **Insights** tab of the Partner Hub shows the Meta-reported usage of all clients of a partner in one place: by period, by message category and by client. It is available to all partners. To open it, click **Insights** in the Partner Hub menu, next to **Clients**.

### Filters

The filter bar sets the data for the whole tab:

* **Period** – **Last 7 days**, **This month** (default, from the 1st of the month up to today), **Last month** or **Custom**. A custom period covers at most 12 months and cannot include future days. Periods longer than 93 days cover whole, complete months.
* **Client** – **All clients** (default) or one client.

The period and the client are stored in the page URL, so reloading the page or sharing the link opens the same view.

### Usage Figures

The tab shows the following figures for the selected period and client:

* **Usage** – The total amount for the period and the change compared with the previous period.
* **Avg. daily usage** – The average amount per day over the last 7 complete days, without provisional days.
* **Chart** – Amounts stacked by message category: per day for periods up to 31 days, per week for periods up to 93 days, and per month for longer periods.
* **By message category** – Charged messages, amount and share for each message category with usage in the period, for example Marketing, Marketing Lite, Utility, Authentication, Service and Voice calls. The list shows the categories that Meta reports, so it can change from period to period.
* **Top clients by usage** – The 5 clients with the highest usage, with their Marketing, Utility, Authentication and total amounts and the change compared with the previous period. All other clients are combined in one **N other clients** row. Click **View all N clients** to see the full ranking, 10 clients per page. Click a client name to show only that client, or click the arrow next to it to open the client's channels. This table shows only when **All clients** is selected.

### Currency and Estimates

The currency of the amounts depends on the payment model:

* **Partner Payment** – Amounts are shown in the currency of the partner balance.
* **Direct Payment** – Clients pay Meta charges from their own balances. Amounts are converted to the partner currency and marked as an estimate.

Amounts are Meta-reported usage, updated daily and converted at the exchange rate of each usage day. Usage from the most recent days is provisional, because Meta can still update it. The chart shows provisional days faded, and a note under the category table gives the date from which usage is provisional. If some usage has no exchange rate yet, a notice lists it and its cost is left out of the amounts. Its messages still count.

### Export Usage

Click **Export CSV** to download the usage of the selected period and client. The file has one row per day, week or month, client and message category, with the client ID and name, charged messages, messages, amount, currency and whether the row is provisional. Clients outside the top 5 are combined in one **Other clients** row.

## Get usage programmatically per channel via API

Check the status and analysis of message usage separately using the following methods:

* [Get Channel Usage](#get-channel-usage)
* [Get Channel Balance](#get-channel-balance)
* [Get Client Balance](#get-client-balance)

#### Get Channel Usage

Retrieve channel-level pricing analytics for messages delivered within a specific date range. This [endpoint](https://docs.360dialog.com/partner/partner-api/api-reference/balance-and-usage.md#get-api-v2-partners-partner_id-clients-client_id-channels-channel_id-info-usage) is aligned with Meta’s pricing structure and provides granular breakdowns.

&#x20;**Overview:**

* Returns current pricing breakdowns for a specific phone number (channel) within a WABA for any messages delivered within a specified date range.
* Abstracts all Meta-specific complexity, so partners don’t need to implement or maintain their own integration with Meta’s pricing services.
* Allows partners to proactively monitor pricing without needing direct integration with Meta.
* Includes MM Lite messaging pricing and statistics

**Rate Limits:**

* 10 requests/hour per phone number (**channel**)
* 200 requests/hour per **WABA**

{% hint style="info" %}
This endpoint offers data directly from Meta. Slight discrepancies may occur with existing info/balance endpoints due to varying usage collection and processing schedules.
{% endhint %}

#### Get Channel Balance

Use this [endpoint](https://docs.360dialog.com/partner/partner-api/api-reference/balance-and-usage.md#get-api-v2-partners-partner_id-clients-client_id-channels-channel_id-info-balance) to retrieve **balance information only** for a specific channel. Usage metrics returned by this endpoint are deprecated and will no longer be returned.

#### Get Client Balance

{% hint style="warning" %}
**Soft Deprecation Notice:** Starting from **July 1, 2025**, the usage portion of this endpoint is **soft-deprecated**.

It previously returned client-level balance and usage data, but is now replaced by **Get Channel Balance** and **Get Channel Usage**.
{% endhint %}

This [endpoint](https://docs.360dialog.com/partner/partner-api/api-reference/balance-and-usage.md#get-api-v2-partners-partner_id-clients-client_id-info-balance) can be used.

\
**Rate Limits:**

* 5 requests per 30 seconds.

The usage part of the response can be up to 5 minutes old. The balance is always current.

## Via Webhook

Webhook events include message-delivery information and conversation context. You can build counters to estimate usage in real time based on those objects.

## FAQ

#### 1. Why are usage numbers different from my invoice?

Usage data in the Hub and API is based on near-real-time processing. Meta’s invoices are finalized monthly and may include adjustments. Minor differences are expected.

#### 2. Does usage tracking work for both Partner and Direct payment accounts?

Yes. Usage tracking is available regardless of payment method. The only difference is who receives the invoice.

#### 3. What happened to the Get client balance endpoint?

It has been deprecated and will no longer return data after July 1, 2025. Use Get channel balance for balance data and Get channel usage for usage analytics.

#### 4. Can I still see usage per WABA or client?

Yes. In the Partner Hub, the **Insights** tab shows usage per client and across all clients (see [**View Usage Across All Clients**](#view-usage-across-all-clients)). Through the API, aggregate the channel-level results from the Get channel usage endpoint across all channels within the WABA or client.

#### 5. What is the best endpoint to use for billing dashboards?

Always use Get channel usage for accurate and detailed analytics. Combine it with Get channel balance for funds tracking.

#### 6. Why are there different granularity options?

Granularity controls how data is grouped in time: use half\_hour for high-resolution analysis, daily for regular monitoring, and monthly for summaries.

#### 7. Are webhooks sufficient to calculate costs?

You can estimate usage from webhooks, but they are not authoritative. Always reconcile against Meta’s monthly invoice for final billing.

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.360dialog.com/partner/partner-hub/checking-usage-and-statistics.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
