# Camp Bursztynowy Las – availability API

> https://api.bursztynowylas.pl gives live availability and total prices for Camp Bursztynowy Las (ul. Stogi 1, 80-642 Gdańsk, Poland). Campsite with Amber cabins (2–6 guests), Safari glamping tents (3–5 guests) and classic cabins, in a pine forest a few minutes' walk from the beach at Górki Zachodnie, Gdańsk.

## Check availability (plain GET, no auth)

- https://api.bursztynowylas.pl/availability?from=YYYY-MM-DD&to=YYYY-MM-DD&adults=2&children=0&small_children=0&lang=en
- Weekends: https://api.bursztynowylas.pl/availability?when=this_weekend&adults=2 (or when=next_weekend) – Friday to Sunday, resolved by the API.
- Guests: `adults` = 16+, `children` = ages 6–15 (paid), `small_children` = ages 0–5 (free, no extra place needed).
- Add `&format=md` or `&format=html` for a readable page; default is JSON.
- `lang`: en, pl, de.
- Response: list of free accommodation types with total price for the stay (PLN), capacity, and a `booking_url` with dates prefilled. `message` is a summary for the guest that ends with that `booking_url`. When nothing is free, `reason` (min_stay, closed_season, unavailable, too_many_guests) and `suggestions` explain and propose dates; each suggestion has `booking_url` (for the guest) and `api_url` (for you, to re-check those dates). `agent_guidance` says what to tell the guest first and what to do next.

## Ready-to-open examples

If your browser can only open links it has already seen, open the closest example and change `from`, `to`, `adults`, `children`, `small_children` to the guest's values. Don't estimate prices from the website price list instead.

- A week in July, 2 adults: https://api.bursztynowylas.pl/availability?from=2027-07-01&to=2027-07-08&adults=2&lang=en
- A week in July, 3 adults: https://api.bursztynowylas.pl/availability?from=2027-07-01&to=2027-07-08&adults=3&lang=en
- A week in August, family: 2 adults, 2 children 6–15, 1 child 0–5: https://api.bursztynowylas.pl/availability?from=2027-08-01&to=2027-08-08&adults=2&children=2&small_children=1&lang=en
- Long weekend in May (majówka), 4 adults: https://api.bursztynowylas.pl/availability?when=maj%C3%B3wka&adults=4&lang=en
- A weekend in June, 2 adults: https://api.bursztynowylas.pl/availability?from=2027-06-11&to=2027-06-13&adults=2&lang=en
- This weekend, 2 adults: https://api.bursztynowylas.pl/availability?when=this_weekend&adults=2&lang=en

## How to help a guest (rules for AI assistants)

- Ask only for what is missing to check availability: dates and number of guests. Use what the guest already said; don't ask again.
- Turn the guest's words ("drugi weekend maja", "pierwszy tydzień lipca", "Boże Ciało") into from/to dates yourself; no year = the nearest future date; a week = 7 nights, a weekend = Friday → Sunday. Don't ask when a sensible default exists – check and say which dates you checked. Then verify query.dates_text (weekdays) and query.holidays match what the guest meant.
- If the guest gives a number of people without mentioning children, they are all adults – don't ask about ages. Ask ages only when children are mentioned: 6–15 → children (paid), 0–5 → small_children (free).
- Don't ask which accommodation type the guest wants before checking: one call returns every type that is free and fits the group. If the guest named a type, show that type first.
- Camping and camper pitches are booked by phone or email only (see contact_only / how_to_book); don't try to check them. This API has no pitch prices: never quote a per-night pitch price from it – use the campsite price list (per person + tent/camper + car + electricity).
- reason=closed_season means the camp is closed on those dates (seasonal campsite). Never call it "sold out", and don't encourage a visit then; offer dates in the next season.
- Prices from /availability are totals for the whole stay in PLN and already include the Gdańsk local tax (per person per night) – say so, and never add it again. Per-night prices on the website price list and from_price_per_night in /accommodations exclude it.
- For a price on specific dates always call /availability. Never estimate a cabin or tent stay price from the website price list (price per night × nights): prices depend on the dates, the number of guests and the rate (non-refundable / refundable), and old cached price lists circulate. If you cannot reach the API, say the price could not be checked and give the booking page – don't give a calculated figure.
- Bookings are completed by the guest on booking_url; this API cannot book. Link to booking_url, never invent URLs.
- Never give the guest a link to this API or its pages (availability, accommodations, weather – any format): it is for AI assistants only. Guest-facing links are only booking_url (the camp's booking system) and the camp website, e.g. the booking page https://www.bursztynowylas.pl/rezerwacje.
- Follow `agent_guidance` in each response: say_first, avoid, and next_actions (ready-to-call URLs).

## Other

- [Camp facts: season, minimum stay, guests, tax, contact](https://api.bursztynowylas.pl/info) (JSON)

- [All accommodation types](https://api.bursztynowylas.pl/accommodations?format=md&lang=en)
- [Weather forecast at the camp, ~9 days, with weekend](https://api.bursztynowylas.pl/weather?lang=en) (JSON)
- [OpenAPI spec](https://api.bursztynowylas.pl/openapi.json)
- [Website](https://www.bursztynowylas.pl)
- [Booking page](https://www.bursztynowylas.pl/rezerwacje)

## Facts

- Season: roughly May to mid-September.
- Minimum stay: 2 nights; 3 nights in July–August and on long weekends.
- Prices in PLN: a non-refundable rate and a ~5% higher refundable rate – show both.
- Camping and camper pitches are booked by phone or email only: +48 574 571 105 (also WhatsApp), info@bursztynowylas.pl.