Fixed
Reviews API (V1): corrected review filters, metadata fields and review status flags
November 16th, 2026
We corrected several Reviews API (V1) reference pages so they match how the API behaves:
- Retrieve review filters and values takes one
order_metadata_fieldsquery parameter: a JSON object that lists the property groups and names you want. The separate per-group parameters were removed because the API ignores them. The page now shows thestatusandresponse.ordersstructure, and thatordersisnullwhen nothing is requested or found. - Create review:
custom_propertiesinorder_metadata,customer_metadataandproduct_metadatais an array ofname/valueobjects (up to 10). Senddelivery_typeinsideorder_metadata.product_urlis optional. - Create question: removed
prevent_duplicate_reviewandreview_source, which the API doesn't read.product_tagsmust be one string with no commas. - Review status fields, for example in Retrieve reviews for a user:
deleted: truemeans the review isn't published on your storefront (pending, rejected or escalated). The review still exists.archived: truemeans it was rejected in moderation, andescalated: truemeans it was escalated in moderation.
