Method
GET /v1/marketplace/offers
Requires the catalog:read scope and workspace context.
Query Parameters
Filter offers to a specific provider ID.
Filter offers applicable to a specific marketplace product. Returns offers where scope is
all, scope is product with no specific products, or applicableProductIds contains this product.Filter offers applicable to a specific departure/sailing. Returns offers where scope is
all, scope is departure with no specific departures, or applicableDepartureIds contains this departure.Filter by offer status:
active, scheduled, expired, or disabled.Filter by offer type:
percentage, fixed_amount, upgrade, addon, bundle, early_bird, or last_minute.Filter by offer scope:
product, departure, cabin_category, room_type, region, or all.Search offers by name.
Page number for pagination.
Number of items per page (max 100).
Headers
Bearer token (e.g.
Authorization: Bearer YOUR_API_KEY)Offer Types
| Type | Description |
|---|---|
percentage | Percentage discount (e.g., “10% off”) |
fixed_amount | Fixed currency amount off (e.g., “$500 off”) |
upgrade | Free upgrade (e.g., “Free cabin upgrade”) |
addon | Free addon (e.g., “Free shore excursion”) |
bundle | Bundle discount |
early_bird | Early booking discount |
last_minute | Last minute discount |
Offer Scopes
| Scope | Description |
|---|---|
product | Applies to specific products |
departure | Applies to specific departures/sailings |
cabin_category | Applies to specific cabin categories |
room_type | Applies to specific room types |
region | Applies to specific destinations/regions |
all | Applies to all eligible items |
Only offers from providers your workspace has an active connection to will be returned.
If you don’t see expected offers, verify your provider connections are active.