Calling API Pricing

Updated: Dec 9, 2025 All user-initiated calls are free.

Overview

Business-initiated calls are charged based on: Duration of the call (calculated in six-second pulses) Country code of the phone number being called. Volume tier (based on minutes called within the calendar month) Note: Our systems count fractional pulses as one pulse. For example, a 56-second call (9.33 pulses) would be counted as 10 pulses. For calls that cross pricing tiers (e.g. from the 0 - 50,000 tier to the 50,001 - 250,000 tier), the entire call is priced at the lower rate (i.e. the rate of the higher volume tier). A valid payment method is required to place calls. Note: Call permission request messages are subject to per-messaging pricing.

Volume-Based Pricing (VBP) rate cards

These rate cards represent the current VBP rates for the WhatsApp Business Calling API effective August 1, 2025: Rates in USD Rates in INR Rates in IDR Rates in EUR Rates in GBP Rates in AUD

How calling changes the 24 hour customer service window

Available since October 1, 2024 Currently, when a WhatsApp user messages you, a 24-hour timer called a customer service window begins, or refreshes. When you are within the window, your business is allowed to send any type of message to the WhatsApp user, which is otherwise not allowed. With the introduction of the Calling API, the customer service window now also starts or refreshes for calls: When a WhatsApp user calls you, regardless of if you accept the call or not When a WhatsApp user accepts your call.

Get cost and call analytics

You can call the GET /<WHATSAPP_BUSINESS_ACCOUNT_ID> endpoint with a ?fields=call_analytics query parameter to obtain call analytics for your WhatsApp Business Account (WABA). The endpoints can provide useful information like cost, counts of completed calls, and average call duration.

Get call analytics

Use this endpoint to get analytics for your calls, like cost, counts of completed calls, and average call duration.

Request syntax

GET /&lt;WHATSAPP_BUSINESS_ACCOUNT_ID&gt;?fields=call_analytics
  .&lt;FILTERING_PARAMETERS&gt;
  &access_token=&lt;ACCESS_TOKEN&gt;

Parameter	Description	Sample Value
`<WHATSAPP_BUSINESS_ACCOUNT_ID>` String	Required Your WhatsApp Business Account ID. Learn how to find your WABA ID	`102290129340398`
`<FILTERING_PARAMETERS>` Multiple	Required Filtering parameters for call analytics data. See Filtering Parameters below	See Filtering Parameters below
`<ACCESS_TOKEN>` String	Required Your access token.

Example response

\{
  "call_analytics": {
    "data": [\
      {\
        "data_points": [\
          {\
            "start": 1676361600,\
            "end": 1676448000,\
            "cost": 10,\
            "count": 10,\
            "average_duration": 1\
          }\
        ]\
      }\
    ]
  },
  "id": "114525791557199"
}

Filtering parameters

Parameter	Description	Sample Value
`start` Integer	Required The unix timestamp start date for the date range you want call analytics for.	`1676361600`
`end` Integer	Required The unix timestamp end date for the date range you want call analytics for.	`1676448000`
`granularity` Enum	Required The desired sampling of the analytics you would like to retrieve. Supported options: `HALF_HOUR` \| `DAILY` \| `MONTHLY`	`MONTHLY`
`country_codes` Array of String	Optional Filter data by country codes which you have called. Provide an array with 2 letter country codes for the countries you would like to include. If `country_codes` is not provided in your filter parameters, analytics for all countries you have called are returned. View list of approved country codes	`["011","55"]`
`phone_numbers` Array of String	Optional Filter data by specific business phone numbers on your WABA. If `phone_numbers` is not provided, all phone numbers added to your WABA are included.	`["550987659923","17862258930"]`
`metric_types` List of Enum	Optional The list of metrics you would like to receive. If metric_types is not provided we return results for all metric types. Supported options: `COST` — Cost calculated for total duration of the call by applying the rate card based on direction of the call and consumer country code. `COUNT` — Total number of calls completed. `AVERAGE_DURATION` — Average duration of calls completed computed by sum of call duration of all calls divided by count of the calls	`[COST, COUNT]`
`directions` Enum	Optional Filter data by the calling direction of the placed call. If `directions` is not provided, all phone numbers added to your WABA are included. Supported options: `USER_INITIATED` \| `BUSINESS_INITIATED`	`BUSINESS_INITIATED`
`dimensions` Enum	Required List of breakdowns you would like to apply to your metrics. If `dimensions` is not provided, we return results without any breakdowns. Supported options: `DIRECTION` \| `COUNTRY` \| `PHONE`	`DIRECTION`

Error response

View Calling API Error Codes and Troubleshooting for more information View general Cloud API Error Codes here

Sample cost and call analytics requests

Only required parameters

Request

GET /{whatsapp-business-account-id}?fields=call_analytics
      .start(1643702400).end(1646121600)
      .granularity(MONTHLY)
      .phone_numbers([])
  &access_token={access-token}

Response

\{
  "call_analytics": {
    "data": [\
      {\
        "data_points": [\
          {\
            "start": 1676361600,\
            "end": 1676448000,\
            "cost": 10,\
            "count": 10,\
            "average_duration": 1\
          }\
        ]\
      }\
    ]
  },
  "id": "114525791557199"
}

With breakdowns

Request

GET /{whatsapp-business-account-id}?fields=call_analytics
      .start(1643702400).end(1646121600)
      .granularity(MONTHLY)
      .dimensions([DIRECTION])
  &access_token={access-token}

Response

\{
  "call_analytics": {
    "data": [\
      {\
        "data_points": [\
          {\
            "start": 1676361600,\
            "end": 1676448000,\
            "direction":"USER_INITIATED",\
            "cost": 0.6,\
            "count": 5,\
            "average_duration": 1\
          },\
          {\
            "start": 1676361600,\
            "end": 1676448000,\
            "direction": "BUSINESS_INITIATED",\
            "cost": 0.4,\
            "count": 5,\
            "average_duration": 1\
          }\
        ]\
      }\
    ]
  },
  "id": "114525791557199"
}

Did you find this page helpful? Thumbs up icon

ON THIS PAGE Overview Volume-Based Pricing (VBP) rate cards How calling changes the 24 hour customer service window Get cost and call analytics Get call analytics Request syntax Example response Filtering parameters Error response Sample cost and call analytics requests Only required parameters Request Response With breakdowns Request Response

Overview

Getting started

Business setup

Messages

Templates

Embedded signup

Flows

Calling

Groups

Payments

Catalogs

Marketing messages

Click to WhatsApp ads

Solution providers

API reference

Pricing

Policies

Other

Support

Pricing

Calling API Pricing

Overview

Volume-Based Pricing (VBP) rate cards

How calling changes the 24 hour customer service window

Get cost and call analytics

Get call analytics

Request syntax

Example response

Filtering parameters

Error response

Sample cost and call analytics requests

Only required parameters

Request

Response

With breakdowns

Request

Response

​Calling API Pricing

​Overview

​Volume-Based Pricing (VBP) rate cards

​How calling changes the 24 hour customer service window

​Get cost and call analytics

​Get call analytics

​Request syntax

​Example response

​Filtering parameters

​Error response

​Sample cost and call analytics requests

​Only required parameters

​Request

​Response

​With breakdowns

​Request

​Response

Calling API Pricing

Overview

Volume-Based Pricing (VBP) rate cards

How calling changes the 24 hour customer service window

Get cost and call analytics

Get call analytics

Request syntax

Example response

Filtering parameters

Error response

Sample cost and call analytics requests

Only required parameters

Request

Response

With breakdowns

Request

Response