For AI platforms & LLM developers
AI Agent Discoverability
Sojournii is a booking platform for experience businesses — tours, classes, events, and activities. Operators on our Kitchen Sink plan can opt in to expose a public booking API, making their experiences, pricing, and availability discoverable by AI assistants and LLM agents. When enabled, their storefront host advertises the API via <link rel="ai-plugin">, JSON-LD, and standard meta tags.
How it works
Each opted-in operator has a business slug (e.g. acme-tours). Use the slug to query their experiences, retrieve details, and create bookings — all without authentication.
1. List available experiences
curl https://data.sojournii.com/api/ai/acme-tours/experiences2. Get experience details (schedule, pricing, availability)
curl https://data.sojournii.com/api/ai/acme-tours/experiences/{experienceId}3. Create a booking
curl -X POST https://data.sojournii.com/api/ai/acme-tours/booking \
-H "Content-Type: application/json" \
-d '{
"scheduledExperienceId": "...",
"firstName": "Jane",
"lastName": "Smith",
"email": "jane@example.com",
"phone": "+15555550100",
"participants": [{ "quantity": 2 }]
}'Rate limits
Limits are per business slug, on a 1-minute sliding window. Per-IP limits are not currently enforced (v1).
| Endpoint type | Limit | Window |
|---|---|---|
| Read (experiences, status, OpenAPI) | 100 / min | per slug |
| Write (calculate price, create booking) | 20 / min | per slug |
| Bootstrap (discovery endpoint) | 600 / min | per slug |
When a limit is exceeded, the API responds with 429 Too Many Requests and includes Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers.
Opt-in per operator, Kitchen Sink tier
AI Agent Discoverability is enabled per operator by their admin on the Kitchen Sink plan. Not all Sojournii operators expose this API — only those who have opted in. Check the operator's storefront host for <link rel="ai-plugin"> or call the /api/ai/{slug}/bootstrap endpoint — it returns {"enabled":false} if the operator has not opted in.
Discovery is currently advertised on *.sojournii.com subdomains only. Verified custom domains are a future feature.