---
title: API documentation: LivingSocial Partner API
url: https://agent.livingsocial.com/docs/for-builders/api
---

# API documentation: LivingSocial Partner API

The LivingSocial Partner API reference for builders. Every endpoint for search, catalog sync, carts and orders, with exact answers and Try it out.

The OpenAPI document, with every request and response in full: https://agent.livingsocial.com/partner-openapi.json

## Operations

17 operations, in the document's order:

- `POST /partner_storefront/bookings/{bookingId}/codes` (`partner_storefront_bookingCodesIssue`): 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.
- `GET /partner_storefront/bookings/{bookingId}` (`partner_storefront_bookingGet`): Read an order: its status, Groupon's purchaser id, and per purchased unit its voucher link and expiry.
- `GET /partner_storefront/bookings` (`partner_storefront_bookingsList`): 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`.
- `DELETE /partner_storefront/carts/{cartId}` (`partner_storefront_cartAbandon`): Abandon a cart.
- `GET /partner_storefront/carts/{cartId}` (`partner_storefront_cartGet`): Read a cart.
- `POST /partner_storefront/carts` (`partner_storefront_cartCreate`): Create a cart with its first items.
- `DELETE /partner_storefront/carts/{cartId}/items/{itemId}` (`partner_storefront_cartItemRemove`): Remove a line.
- `PATCH /partner_storefront/carts/{cartId}/items/{itemId}` (`partner_storefront_cartItemUpdate`): Set a line's quantity (1-100).
- `POST /partner_storefront/carts/{cartId}/items` (`partner_storefront_cartItemsAdd`): Add items.
- `GET /partner_storefront/categories` (`partner_storefront_categoriesList`): 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.
- `GET /partner_storefront/products/{productId}/availability` (`partner_storefront_productAvailability`): 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.
- `GET /partner_storefront/products/{productId}` (`partner_storefront_productGet`): 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.
- `POST /partner_storefront/products/{productId}/holds` (`partner_storefront_productHoldCreate`): Hold the tickets of one free slot of a product booked on groupon.com, so the shopper pays for exactly that day and time.
- `GET /partner_storefront/products/{productId}/stays` (`partner_storefront_productStays`): 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`).
- `GET /partner_storefront/products` (`partner_storefront_productsList`): One page of deals.
- `GET /partner_storefront/products/search` (`partner_storefront_productsSearch`): 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.
- `GET /partner_storefront/me` (`partner_storefront_storefrontMe`): Read your storefront's registration: its partner id, scope, logo and redirect URL, CJ publisher id and status.