Skip to main content
GET
List products
Required scope: products:read Rate limit: 300 requests/minute A “product” is a voucher design / SKU configured in the VoucherGrid Design Centre – for example, a $50 Birthday voucher or a Custom Amount voucher.

Pagination

Supports both cursor pagination (recommended) and page pagination (deprecated). The cursor shape wins if both are supplied. Cursor mode forces ORDER BY created_at DESC, id DESC and ignores the legacy sort_order column on the underlying table.

Query parameters

Page shape (deprecated)

Use cursor pagination for new integrations – see Pagination.

Filters (both shapes)

Response

Cursor shape:
Page shape (deprecated):
pricing_type is one of:
  • fixed – single set price (shown as Face Value in the Design Centre), in fixed_amount.
  • range – price between min_amount and max_amount.
  • custom – price entered by the buyer (no preset bounds).

Errors

  • 400 – Invalid status value, or invalid/forged/cross-tenant cursor.

Examples