Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.omneo.io/llms.txt

Use this file to discover all available pages before exploring further.

List Reservations allow items on a shared list to be “reserved” — indicating that someone intends to purchase that item. This is particularly useful for gift registry scenarios where multiple people are shopping for a single customer.

How reservations work

  1. A customer creates a list (e.g., a wedding registry) and shares it via a shareable link
  2. A gift-giver views the shared list and selects items they intend to buy
  3. The gift-giver creates a reservation on those items
  4. The registry owner’s list shows those items as reserved, preventing duplicates

Reservation fields

FieldDescription
list_item_idThe list item being reserved
quantityNumber of units being reserved
reserver_nameOptional name of the person reserving (for display to the list owner)
statusReservation status (pending, purchased, cancelled)

Reservation lifecycle

  • Created — a reservation is placed on a list item
  • Purchased — the reserver confirms they completed the purchase
  • Cancelled — the reservation is released (item becomes available again)

API

Reservations are managed via the List Reservations API. Staff can view and manage reservations in Clienteling.