Get latest stored report

Returns the most recent stored insight report for a target identity (store + review site + period + theme), read entirely from our database — it never calls ReviewData and never consumes usage. When no matching report exists, data.found is false, signalling the UI to offer a Generate action.

Auth: Both — authentication; store_id scoped by an ownership check (auth-company-tree walk). A Partner reaches any store in its sub-tree; an Account only its own stores. The match also keys on review_site_id (null vs specific), year, month (null = full-year), and theme, returning the latest (id) match.

Rate limit: No rate limit.

Request

  • Body (all top-level, JSON):
FieldTypeRequiredNotes
store_idintegeryesMust be an existing location inside your own account tree.
review_site_idintegernoMust be an existing review site and must be linked to the store; omit to match the all-publisher report (matched as review_site_id IS NULL).
yearintegeryesbetween:2000,2100.
monthintegernobetween:1,12. Omit to match the full-year report.
themestringyesmax:64.

Response{ data. } envelope, HTTP 200.

  • When no report exists: { "found": false } only.
  • When found: found (boolean, true) plus the full present payload: insight_report_id (integer), store_id (integer), review_site_id (integer|null), publisher (string), year (integer), month (integer|null), theme (string), status (string), task_id (string|null), review_count (integer|null), result_summary (object|null), failure_reason (string|null), failure_details (object|null), completed_at (string|null, ISO-8601).

Errors: 422 on validation failure.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
integer
integer
integer
integer
string
Response

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json