Locations table (partner)

Returns a paginated, per-location (per-store) review-response table for the partner — reviews, responses, average response time, average rating, and response rate per store.

Auth: Partner — authentication; under partner/report group. Handler hard-gates on company.bundle_id == 1. Store set precedence: store_id → single store; else account_id (account); else all partner stores. All id params guarded by an ownership check.

Rate limit: No rate limit.

Request

  • Body:
FieldTypeRequiredNotes
range_startstringyesY-m-d H:i:s
range_endstringyesY-m-d H:i:s
store_idintegernobelongs to auth company
account_idintegernoaccount (bundle_id=3) under this partner
client_location_idstringnoresolved to store_id
client_account_idstringnoresolved to account_id
sort_fieldstringnoone of location_name,total_reviews,total_responses,avg_resp_time,avg_rating,response_rate (default location_name)
sort_bystringnoasc/ASC/desc/DESC (default ASC)
search_fieldstringnoonly location_name
search_valuestringnosearch term
limitintegernoper page (default 10)
pageintegernopage number

Response — paginated resource collection, data array + paginator meta.

  • data[].id (int) — store id
  • data[].location_name (string) — name - storeid (or the name alone)
  • data[].total_reviews (int) / data[].total_responses (int)
  • data[].avg_resp_time (float) — days (minutes/(24*60), rounded 2dp)
  • data[].avg_rating (float) / data[].response_rate (float, percentage)
  • current_page, last_page, per_page, total (paginator meta)

Errors: 422 on validation failure.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
string
integer
string
string
integer
integer
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