Paginated traveler reviews
Returns visible traveler reviews across the Safariat catalog. Results are ordered by
most recent first. Pagination is cursor-based — pass the cursor received in
meta.next_cursor to fetch the next page; no next_cursor → end of the result set.
Hidden / moderated reviews are never exposed. Reviews can target an EXPERIENCE,
a TRIP, or an AGENCY; the reviewable_id correlates with the matching record
from GET /adventures/{slug} or the agency identifier returned in the adventure
record.
Requires scope reviews:read.
Authorizations
API key authentication. Issued by the Safariat admin or via the partner portal. The secret is shown only once at generation.
Production sk_live_* keys must additionally sign every write request
(POST/PUT/DELETE) with the X-Timestamp and X-Signature headers.
Sandbox sk_test_* keys are exempt from request signing: X-Signature and
X-Timestamp are not required for writes in the sandbox (so the developer-portal
"Try it" playground works end to end). The Idempotency-Key header remains
required on writes in both environments.
Query Parameters
Restrict to reviews of a single adventure (EXPERIENCE or TRIP). Unknown slug returns an empty page.
200^[a-z0-9-]+$Minimum rating (inclusive).
1 <= x <= 5When true, only reviews tied to a confirmed booking are returned.
Opaque pagination cursor returned by the previous response in meta.next_cursor.
Pass null/omit on the first request; absence of next_cursor in the response
signals the last page. Treat the cursor as fully opaque — its format is internal
and may evolve.
Keyset pagination (all listing endpoints except /adventures). The cursor
is anchored on the last row of the previous page, so results are stable under
concurrent writes — no duplicates, no skipped rows when items are inserted
between page fetches. Two cursors are not interchangeable across endpoints:
a cursor obtained from /reviews will be rejected with 400 on /bookings.
/adventures is offset-based by design (dynamic sort: popularity, price,
distance) and will not migrate to keyset. Its cursor cannot be passed to other
endpoints.
Behavior change (Phase B): /webhooks/deliveries now sorts by created_at
instead of updated_at. The previous sort field is mutable (retry attempts),
which is incompatible with the keyset invariant. Use the status filter to
surface deliveries currently being retried (status=PENDING,FAILED).
256Maximum number of items per page.
1 <= x <= 100