Understory Developer Platform

Build booking flows, storefronts, marketing automation and accounting integrations on the Understory API.

List your experiences with a single request. The quickstart takes you from integration key to first call in about 10 minutes.

curl https://api.understory.io/v1/experiences \
  -H "Authorization: Bearer $ACCESS_TOKEN"

What you can build

List experiences and upcoming events with live availability, then send visitors straight into checkout.

Subscribe to webhooks for bookings, events and experiences, and update your own data as things change.

Pick up marketing consents as guests give them and pass them on to your email or CRM tools.

Read the journal entries Understory records for bookings and gift cards, with their supporting documents.

Marketplaces and SaaS tools connect to their customers’ Understory accounts with OAuth2.0 consent.

Give your coding assistant llms.txt, Markdown versions of every page and the rules for calling the API.

A REST API with OAuth2.0 authentication, JSON everywhere and webhooks for changes.

The products a company offers, such as tours and workshops.

Scheduled, bookable dates of an experience.

What can be booked, when, and for how many guests.

Guests’ reservations against events.

The financial side of a purchase: line items and refunds.

Prepaid balances guests redeem against purchases.

Where experiences take place, and their time zones.

Marketing consents guests have given.

Journal entries for bookings and gift cards.

Subscriptions that notify you when something changes.

Every page is available as Markdown, and llms.txt gives your assistant an index of the docs and the rules for calling the API.

Questions about building an integration? Chat with the team behind the API.