API documentation

POST /partner_storefront/bookings/{bookingId}/codes

Issue an order's codes: for every voucher of the order, or the unitIds you name, the code the shopper presents at the merchant, its barcode format and its expiry.

partner_storefront_bookingCodesIssue

GET /partner_storefront/bookings/{bookingId}

Read an order: its status, Groupon's purchaser id, and per purchased unit its voucher link and expiry.

partner_storefront_bookingGet

GET /partner_storefront/bookings

List your storefront's orders: every order placed from a cart your keys made since 2026-10-15, and every order Groupon's checkout paid against a hold your keys placed (it names the hold in holdId), newest cart or hold first, with its status as Groupon last answered it (REFUNDED for a refund, REJECTED for a cancel of an order never seen paid, a declined payment), its value once paid, when it was paid and its bookingId.

partner_storefront_bookingsList

DELETE /partner_storefront/carts/{cartId}

Abandon a cart.

partner_storefront_cartAbandon

GET /partner_storefront/carts/{cartId}

Read a cart.

partner_storefront_cartGet

POST /partner_storefront/carts

Create a cart with its first items.

partner_storefront_cartCreate

DELETE /partner_storefront/carts/{cartId}/items/{itemId}

Remove a line.

partner_storefront_cartItemRemove

PATCH /partner_storefront/carts/{cartId}/items/{itemId}

Set a line's quantity (1-100).

partner_storefront_cartItemUpdate

POST /partner_storefront/carts/{cartId}/items

Add items.

partner_storefront_cartItemsAdd

GET /partner_storefront/categories

Every category path of the deals on sale in your scope, by path: send its category0, category1 or category2 as the filter of the same name on the products walk or the search.

partner_storefront_categoriesList

GET /partner_storefront/products/{productId}/availability

The free slots of a product booked on groupon.com (its options carry a bookingUrl), for the next seven days or the days you name: date for one day, or dateFrom and dateTo for up to seven days, at the venue.

partner_storefront_productAvailability

GET /partner_storefront/products/{productId}

One product, on sale or sold out, as the walk answers it: refresh a stored product, or check one before you put it in front of a shopper.

partner_storefront_productGet

POST /partner_storefront/products/{productId}/holds

Hold the tickets of one free slot of a product booked on groupon.com, so the shopper pays for exactly that day and time.

partner_storefront_productHoldCreate

GET /partner_storefront/products/{productId}/stays

The rooms and rates of a hotel stay (hotelStay: true) for the dates and one room's guests you name: checkIn and checkOut (YYYY-MM-DD, 1 to 28 nights, check-in from yesterday to a year ahead), adults (1 to 4, 2 by default) and children (up to 2 ages from 0 to 17, 4,9).

partner_storefront_productStays

GET /partner_storefront/products

One page of deals.

partner_storefront_productsList

GET /partner_storefront/products/search

One page of the deals that match the shopper's words, best first: send q (a place in the words is read: massage in Chicago), narrow with city or near (a radius in km or mi), minPrice and maxPrice, minRating (only merchants rated at least this), a category (GET /partner_storefront/categories lists yours) or a state inside your scope, order them with sort (rating, price_asc, price_desc; Groupon's relevance when absent), and pass nextCursor back as cursor with the same parameters until hasMore is false.

partner_storefront_productsSearch

GET /partner_storefront/me

Read your storefront's registration: its partner id, scope, logo and redirect URL, CJ publisher id and status.

partner_storefront_storefrontMe