Iconic Expeditions

Search Content

Search Iconic Expeditions content across itineraries, activities, destinations, and posts. Flows through the content chain (WordPress -> local cache -> AI fallback), so gaps WordPress doesn't cover are filled with clearly-labeled AI-synthesized results. Each item includes a `source` field (wordpress | cache | ai).

Search Content (alias)

Alias of search_content, kept for backwards compatibility. Prefer search_content.

Get Content Item

Fetch a single content item by type and id, walking the content chain (WordPress -> cache). Returns the item with its `source`.

Get Content Item (alias)

Alias of get_content, kept for backwards compatibility. Prefer get_content.

List Destinations

List destinations from the database, optionally filtered by region or category.

Get Destination

Get full details for a single destination by slug or id.

Get Itinerary

Get a full itinerary with all days and activities, sorted by day number and time slot. Public itineraries are readable without a token; private ones require the owning token.

List Concierge Itineraries

List itineraries created by the Iconic Expeditions concierge, most recent first. Requires a bearer token.

Create Itinerary

Create a new (empty) itinerary attributed to the Iconic Expeditions concierge, made public and returned with its share link. Days are created automatically. Requires a bearer token.

Generate Itinerary from Places

Give at least 3 places plus optional traveller preferences and let the AI concierge build a full, bespoke day-by-day itinerary. It mines Iconic Expeditions content for real detail and synthesizes an ORIGINAL plan tailored to the guest (never a copy of a published itinerary). Attributed to the Iconic Expeditions account and made public. Returns immediately with the itinerary id + share link; poll get_itinerary for progress (generation_status: pending -> building -> complete). Requires a bearer to

Update Itinerary

Update metadata (title, description, dates, public status) on a concierge itinerary. Requires a bearer token.

Delete Itinerary

Permanently delete a concierge itinerary and all its days and activities. Requires a bearer token.

Add Day to Itinerary

Append an extra day to a concierge itinerary and increment num_days. Requires a bearer token.

Get Itinerary Dossier

Read an itinerary's planning dossier: its legs, month-by-month seasonality, cost model, booking order, field notes and open choices. Public — no token needed. Returns nulls for blocks the itinerary doesn't have; older itineraries have none of them.

Price an Itinerary

Price an itinerary's cost model against a selection: a comfort tier, any per-line choices, a trip length and a traveller count. Returns the per-person line breakdown and the group total. Public — no token needed. Amounts are in minor units. Call get_itinerary_dossier first for the tier and option ids.

Write an Itinerary's Dossier

Write the planning layer above an itinerary's day-by-day. Every block is optional — send only the ones you mean to write. Each block you DO send REPLACES that block entirely, so restate it in full: a partial legs list silently deletes the rest of the legs. Requires a bearer token.

Write a Day's Detail

Write one day out at length — why it is shaped this way, what its timing depends on, what the alternatives cost — plus up to three callouts. Replaces that day's existing narrative and callouts. Requires a bearer token.

Add Activity to Day

Add an activity to a specific day and time slot (morning/afternoon/evening). Optionally link to a content item using its type and id. Requires a bearer token.

Delete Activity

Remove an activity from a concierge itinerary day. Requires a bearer token.

Get Concierge Pricing

List the paid concierge service tiers and their prices: itinerary verification, verification + full booking, and full guided service. Read-only and public — use this to quote a traveller before they buy.

Request Itinerary Verification ($50)

Start a PAID itinerary verification. Our travel experts manually confirm availability, seasonality, routing and current lodge rates, then return a feasibility report and final price. Returns a Stripe checkout URL. Requires a bearer token.

Request Verification + Bookings ($100)

Start a PAID booking service: verification PLUS we make all the bookings (lodges, transfers, activities, permits). Returns a Stripe checkout URL. Requires a bearer token.

Request Full Guided Service ($500 deposit)

Start a PAID full-service, fully-guided expedition with Iconic Expeditions guides. This $500 is a deposit; the final custom price is quoted by an expert afterward based on the itinerary. Returns a Stripe checkout URL. Requires a bearer token.