List monthly billing statements by ad account ID
Returns monthly billing statements for the given ad account, newest first. Only available to ad account admins. Non-credit-card accounts have no statements and receive an empty list.
Request
- ad_account_idstring [uuid]Required
A unique identifier for an Ad Account.
Example:ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a - start_yearinteger [int32]
Inclusive start year of the statement billing-period filter. Filters on the period the spend occurred (year/month), not the statement creation date. Provide together with start_month, end_year and end_month, or omit all four for all-time results.
Range:1970-9999Example:start_year=2025 - start_monthinteger [int32]
Inclusive start month (1-12) of the statement billing-period filter.
Range:1-12Example:start_month=1 - end_yearinteger [int32]
Inclusive end year of the statement billing-period filter.
Range:1970-9999Example:end_year=2025 - end_monthinteger [int32]
Inclusive end month (1-12) of the statement billing-period filter.
Range:1-12Example:end_month=12 - limitinteger
Limit or page size for a given response.
Default:limit=50Range:1-50Example:limit=50 - offsetinteger
Starting position of the next record to assist in data pagination.
Default:offset=0Example:offset=0
Response
A page of monthly billing statements for the ad account.
A page of monthly billing statement summaries.
The statement summaries for the requested page, newest first.
Lightweight monthly billing statement summary for list views.
- statement_idstring [uuid]
A unique identifier for the entity.
Example:"ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a" - statement_typestring
The type of billing statement. The list endpoints only return BILLING_MONTHLY today; additional values may appear in future and should be treated as opaque by clients.
Example:"BILLING_MONTHLY" - ad_account_idstring [uuid]
A unique identifier for the entity.
Example:"ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a" - account_namestring
Display name of the ad account at the time the statement was generated.
Example:"US - Growth" - yearinteger [int32]
Billing-period year the statement covers.
Example:2025 - monthinteger [int32]
Billing-period month (1-12) the statement covers.
Example:12 - created_atstring [date-time]
Date the entity was created. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
Example:"2026-01-23T04:56:07Z"
- page_sizeinteger [int32]
- total_resultsinteger [int32]
- offsetinteger [int32]
- current_pageinteger [int32]
Response sample
{ "statements": [ { "statement_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a", "statement_type": "BILLING_MONTHLY", "ad_account_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a", "account_name": "US - Growth", "year": 2025, "month": 12, "created_at": "2026-01-23T04:56:07Z" } ], "paging": { "page_size": 0, "total_results": 0, "offset": 0, "current_page": 0 }}