Skip to main content
GET
List approved prices
Returns the prices your team approved in the Price Approval queue - the finalized decisions, not raw agent proposals. Use it to pull approved prices into your ERP, webshop, or POS on a schedule instead of exporting by hand. One row is returned per approved price. When a grid is in SKU-Store view, each approval carries its own store_id.

Authentication

Bearer token. See Authentication.

Query parameters

All parameters are optional. With none set, the endpoint returns your organization’s current pending exports - the approved prices that have not yet been acknowledged as processed downstream - newest first. Pass history=true to read the full registered history instead.

Response

Response fields

Money values are returned as strings - see Conventions.

Example request

Page through results by passing the next_cursor from each response back as cursor until it comes back null.

Acknowledge what you processed

Because the default read returns only pending exports, a price stays in that set until you tell Retailgrid you’ve applied it. Confirm a batch with:
Pass the id values from a previous list response, up to 500 per call. Acknowledged prices drop out of the default pending read, so a scheduled integration can loop list → apply → acknowledge without tracking a cursor or a watermark of its own. A 409 means the batch conflicts with the current state of those exports (for example one was cancelled or already acknowledged). Re-read the ids and retry with the ones still pending rather than retrying the same batch.