Restaurant and countries

Public booking API · https://api.conciar.com/public/v1

INFO

Die API-Referenz ist auf Englisch.

Get booking settings

Whether the restaurant takes online bookings (available, and a reason when not: NO_RESTAURANT, RESERVATIONS_OFF or NO_TABLES), the restaurant details, the booking window and party limits, deposit and no-show settings, and links to the hosted booking page. Also returns the booking page texts (t, tp) in the chosen language.

GET/public/v1/restaurants/{organization_guid}

Kein Schlüssel

Rate Limit: 120/min per restaurant and IP

Pfadparameter

• organization_guidstringerforderlich

  The restaurant's guid or its handle (any case, a leading @ is ignored; former handles still resolve).

Query-Parameter

• langstring

  en, nl, de, fr or es. Falls back to Accept-Language, then the restaurant's language, then en.

Statuscodes

• 404NOT_FOUND — no such restaurant.

Gut zu wissen

• A restaurant that takes no online bookings still answers 200, with available: false and the reason. booking.deposit_per_person is money {amount, minor, currency} or null; booking.no_show_protection is null, none, deposit or guarantee; links.events is null when there are no ticketed events.

curl "https://api.conciar.com/public/v1/restaurants/bistro-example" \
  -H "Accept: application/json"

Beispielantwort · 200

{
  "status": true,
  "available": true,
  "reason": null,
  "locale": "en",
  "locales": [
    "en",
    "nl",
    "de",
    "fr",
    "es"
  ],
  "restaurant": {
    "guid": "00000000000000000",
    "handle": "bistro-example",
    "name": "Bistro Example",
    "logo": null,
    "accent": "#1f6f5c",
    "address": "Example Street 1, 1000 AA Example City",
    "phone": null,
    "email": "hello@example.com",
    "country_id": 150
  },
  "booking": {
    "max_party": 8,
    "party_cap": 20,
    "first_day": "2026-10-16",
    "last_day": "2027-01-14",
    "hold_minutes": 30,
    "deposit_per_person": null,
    "no_show_protection": null,
    "free_cancellation_hours": 24
  },
  "links": {
    "booking_page": "https://r.conciar.com/bistro-example?lang=en",
    "events": "https://r.conciar.com/bistro-example/events?lang=en"
  },
  "gift_cards": {
    "enabled": false,
    "url": null
  },
  "t": {
    "…": "…"
  },
  "tp": {
    "…": "…"
  }
}

List countries

Every country with its localized name and calling prefix, sorted by name, for the phone field. Cached for a day (Cache-Control: public, max-age=86400).

GET/public/v1/countries

Kein Schlüssel

Rate Limit: 60/min per IP

Query-Parameter

• langstring

  en, nl, de, fr or es. Falls back to Accept-Language, then en.

curl "https://api.conciar.com/public/v1/countries?lang=en" \
  -H "Accept: application/json"

Beispielantwort · 200

{
  "status": true,
  "locale": "en",
  "countries": [
    {
      "id": 150,
      "name": "Netherlands",
      "iso": "NL",
      "prefix": 31
    }
  ]
}