v1

latestOpenAPI 3.1.02026-07-2616459400.5 KB

WhatsApp Reach Estimate

Get Reach Estimate API

Retrieve expected delivery and cost ranges for marketing messages sent from the specified WABA to users in the given country. Estimates are derived from historical performance over the selected lookback period.

get/v3/metainfo/reach_estimate

Query parameters

waba_idstring

WhatsApp Business Account ID for which to fetch reach estimates.

countrystring

ISO 3166-1 alpha-2 country code for the target audience, e.g. IN for India.

date_interval'L1D' | 'L7D' | 'L14D' | 'L28D' required

Historical lookback window used to compute estimates. Supported values: L1D (last 1 day), L7D (last 7 days), L14D (last 14 days), L28D (last 28 days).

Headers

Content-Typestring required

Example:application/json

Must be set to application/json.

Response

Reach estimate fetched successfully

request_idstring

Unique identifier for this API request. Use when contacting support.

statusstring

Indicates whether the request succeeded or failed.

messagestring

Human-readable summary of the API result.

Example response

{
  "request_id": "1783066501446107307-8c8ddf44c2db52d2",
  "status": "success",
  "message": "Reach estimate fetched successfully",
  "data": {
    "waba_currency": "INR",
    "estimates": [
      {
        "bid_amount": 21577,
        "users": 1000
      }
    ]
  }
}