Ad Account Reporting

Updated: Feb 5, 2026

Copy for LLM

Ads in WhatsApp Status are available via the Marketing API. Learn more about ads in WhatsApp Status.

Reading

Provides the Report Builder’s response.

Example

Select language

GET /v25.0/{ad-account-id}/reporting HTTP/1.1
Host: graph.facebook.com

Try it in Graph API Explorer

If you want to learn how to use the Graph API, read our Using Graph API guide

Parameters

Parameter	Description
`action_report_time` enum {impression, conversion, mixed, lifetime}	action_report_time
`attribution_windows` array<enum {1d_view, 7d_view, 28d_view, 1d_click, 7d_click, 28d_click, 1d_ev, dda, default, 7d_view_first_conversion, 28d_view_first_conversion, 7d_view_all_conversions, 28d_view_all_conversions, skan_view, skan_click, skan_click_second_postback, skan_view_second_postback, skan_click_third_postback, skan_view_third_postback}>	Attribution window for the actions.
`comparison_time_range` {‘since’:YYYY-MM-DD,’until’:YYYY-MM-DD}	Map of time range objects for comparison. `since` datetime A date in the format of "YYYY-MM-DD", which means from the beginning midnight of that day. `until` datetime A date in the format of "YYYY-MM-DD", which means to the beginning midnight of the following day. Show child parameters
`date_preset` enum {today, yesterday, this_month, last_month, this_quarter, maximum, data_maximum, last_3d, last_7d, last_14d, last_28d, last_30d, last_90d, last_week_mon_sun, last_week_sun_sat, last_quarter, last_year, this_week_mon_today, this_week_sun_today, this_year}	The date preset. Represents a relative time range.
`default_summary` boolean	Determine whether to return a summary. If this param is used, a summary section will be included with the metrics.
`dimension_groups` array<array<string>>	The groups of dimensions, where each group is treated one dimension.
`dimensions` array<string>	The dimensions required in the report.
`filtering` Filters used in report builder	Default value: `Vec` Fields for the report to be filtered on. `field` string required `operator` enum {EQUAL, NOT_EQUAL, GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL, IN_RANGE, NOT_IN_RANGE, CONTAIN, NOT_CONTAIN, CONTAINS_ANY, CONTAINS_ALL, NOT_CONTAINS_ANY, STEM_MATCH, IN, NOT_IN, STARTS_WITH, ENDS_WITH, ANY, ALL, AFTER, BEFORE, ON_OR_AFTER, ON_OR_BEFORE, NONE, TOP} required `value` string required Show child parameters
`formatting` JSON object {string : array<JSON object>}	conditional formatting
`last_dimension` JSON object {string : string}	Last dimesion values returned in previous request. If provided, API will seek from this poistion in saved pagination.
`last_report_snapshot_id` int64	The last report snapshot ID.
`limit` integer	The limit on number of data rows requested.
`locked_dimensions` int64	Default value: `0` The locked dimensions.
`metrics` array<string>	The metrics whose values are required.
`offset` int64	Indicates the offset.
`pagination_key` string	Internal application pagination key. If provided, API will seek saved pagination.
`sorting` array<JSON object>	Represents the sorting fields and their sort directions. `field` string field required `direction` enum {asc, desc} Default value: `"desc"` direction Show child parameters
`summary_count` boolean	Determine whether to return the count of all rows.
`time_range` {‘since’:YYYY-MM-DD,’until’:YYYY-MM-DD}	The time range. `since` datetime A date in the format of "YYYY-MM-DD", which means from the beginning midnight of that day. `until` datetime A date in the format of "YYYY-MM-DD", which means to the beginning midnight of the following day. Show child parameters

Fields

Reading from this edge will return a JSON formatted result:

{
"data": [],
"paging": {},
"summary": {}
}

data

A list of AdsReportBuilder nodes.

paging

For more details about pagination, see the Graph API guide.

summary

Aggregated information about the edge, such as counts. Specify the fields to fetch in the summary param (like summary=__type__).

Field	Description
`headers` AdsReportBuilderHeader	Contains the header information (includes dimensions, columns etc) default
`rows` list<AdsReportBuilderRow>	Contains data rows. default
`total_count` int32	Total number of rows default

Error Codes

Error Code	Description
2616	The reporting data you are trying to fetch has too many rows. Please pull data for shorter time periods or use filters to restrict the number of ad IDs
100	Invalid parameter
190	Invalid OAuth 2.0 Access Token
200	Permissions error