Yext Knowledge API icon

Yext Knowledge API

Interact with Yext Knowledge API

Actions176

Reviews → List Review Invitations

AI-generated

Summary

List review invitations for a specified account with optional filtering and pagination support.

Inputs

  • Account Id (required) — The unique identifier of the Yext account to list review invitations from.
  • V (required) — API version date in YYYYMMDD format, required for the request.
  • Limit — Maximum number of review invitations to return (default is 10).
  • Offset — Number of review invitations to skip for paging (cannot be used with pageToken).
  • Page Token — Token string to retrieve the next page of results when pagination is used (effective with API version 20240626 or later).
  • Location Ids — List of location IDs to filter invitations returned (only invitations for these locations).
  • Folder Ids — List of folder IDs to restrict invitations to locations in those folders and subfolders.
  • Location Labels — List of labels to filter invitations by locations that have any of the provided labels.
  • Template Ids — List of template IDs to limit invitations to those using the specified templates.
  • Status — Filter invitations by their status: ACCEPTED, REJECTED, or PENDING (default is ACCEPTED).
  • Type — Filter invitations by type: EMAIL or SMS (default is EMAIL).

Output shape

a JSON object containing a list of review invitations matching the criteria, potentially paginated with nextPageToken for fetching subsequent pages.

Pagination is supported via 'offset' for API versions before 20240626 and 'pageToken' for version 20240626 or later. The 'limit' parameter controls page size. Filtering available on multiple fields allows granular retrieval of invitations.

Discussion