Ranks the authenticated account's locations against each other over a date range — by review volume, average rating, and response rate — and computes a blended overall rank with a letter grade.

Auth: Both — authentication (Passport bearer). Inside rankingReport the caller's company bundle_id must be 3 (account) or 2 (location-account); any other role gets a 403. Walking UP resolves the account name. Store scope comes from unless you supply store_id. Per-role difference: reachable stores differ — a location-level user (bundle_id=2 / assign_location) sees only its assigned store(s), while an account-level user sees every store under the account's location-account children. The optional store_id must sit inside your own account tree, so it must resolve to a store inside the caller's own hierarchy.

Rate limit: No rate limit.

Request

• Body (all in JSON body):

Response — { data. } envelope.

• account_name (string) — the parent account company name (null if no account resolved).
• interval (object) — start and end, echoed verbatim from the request.
• locationRank (object) — four arrays of per-location rows:
• byReview (array) — locations ranked by review_count; each row: id, name, review_count, response_count, response_percent, avgRating, rank.
• byRate (array) — same row shape, ranked by avgRating.
• byResponse (array) — same row shape, ranked by response_percent.
• overAll (array) — each row adds reviewRank, rateRank, responseRank, totalRank (sum of the three), final_grade (A+/A/B/C/D), final_grade_point. When there are 10+ distinct total ranks, a percentage_rank band (e.g. Top 10%) is also added.
• When no locations have data, all four arrays are empty.

Errors: 422 on validation failure.