Returns the last 12 months (relative to date) of per-month review volume, average rating, cumulative overall rating, and response counts for an account or a single store — used to drive the annual volume + rating chart.

Auth: Both — authentication (mounted under the top-level api. group, not a partner/* prefix). Every identifier param runs through an ownership check, which resolves the target to a company id and rejects anything outside the caller's tree. An account caller (bundle_id=3) passes its own account_id/store_id or its own client_account_id/client_location_id. A partner caller (bundle_id=1) may pass any account/store under its child tree, and external client ids are resolved against the partner's full descendant set. account_id must reference a bundle_id=3 (account) company row.

Rate limit: No rate limit.

Request

• Body:

*At least one of account_id, store_id, client_location_id, client_account_id is required (required_without_all).

Response — { data. } envelope. The payload is { status, data } where data is a 12-element array (oldest month first), one entry per month:

• status (string) — always "success".
• data[].month (string) — month label formatted F-Y, e.g. "June-2026".
• data[].reviews (int) — count of qualifying reviews in that month.
• data[].avg_rating (float) — average rate of that month's reviews (0 if none).
• data[].overall_rating (float) — cumulative average rate of all qualifying reviews up to and including the end of that month.
• data[].responses (int) — count of reviews in that month that have a recorded response.

Errors: 422 on validation failure.