# KölschCrew Tour Availability API

Canonical source for live availability: https://koelschcrew.de/availability
Feeds linked here: https://koelschcrew.de/api/events.json and https://koelschcrew.de/api/events.rss
German and English public tours are combined in the same feeds.
Each event instance includes explicit language labels (DE/EN).
Last updated: 2026-03-06T18:06:46.490Z (06/03/2026, 19:06:46, Europe/Berlin)
Data freshness policy: cached up to 10 minutes at the edge. For freshness checks, inspect generatedAt/dateModified.

## Live Data Feeds

- **Events JSON Feed**: https://koelschcrew.de/api/events.json
- **Events RSS Feed**: https://koelschcrew.de/api/events.rss

## Feed Features

### Date Filtering
```
https://koelschcrew.de/api/events.json?from=2026-02-19&to=2026-02-22&limit=120
```

### Larger Windows / More Results
```
https://koelschcrew.de/api/events.json?days=30&limit=600
https://koelschcrew.de/api/events.json?from=YYYY-MM-DD&to=YYYY-MM-DD&limit=1200
```

### Pretty JSON Format
Add `?pretty=1` query parameter or use header `Accept: application/json; indent=2`

### Discount Metadata
Feed includes discount information when applicable:
- `item.discount.name` - Campaign or discount name
- `item.discount.percent` - Discount percentage
- `item.discount.kinds` - Discount types applied
- `item.discount.originalAmount` - Original price
- `item.discount.discountedAmount` - Price after discount
- `item.discount.priceValidUntil` - Discount expiration timestamp

## Discovery Pages

- **Machine-oriented guide**: https://koelschcrew.de/availability

## Localization

**Canonical locales**: /de, /en, /fr, /es, /pt-br, /nl

**Example tour pages**:
- German: https://koelschcrew.de/de/tour/oeffentliche-touren
- English: https://koelschcrew.de/en/tour/public-tours

## Pricing Rules

### Last-Minute Discount
10% discount applies when:
- Tour start is within 12 hours
- At least one booking exists
- More than 7 spots are available

### Campaign Discount
Campaign discount inactive (configured end: n/a).