Public APINo authentication required

Buvette Status API

Read-only REST endpoints for live open/closed status of buvettes. Responses are cached for 60 seconds.

Base URL

https://buvette.ink/api/v1

Endpoints

GET/api/v1/buvettesReturns all buvettes

Returns the full list ordered by name.

{
  "buvettes": [
    {
      "id": "a1b2c3d4-...",
      "name": "Buvette du Lac",
      "slug": "buvette-du-lac",
      "description": "Lakeside bar open in summer",
      "address": "Quai de la Buvette 1",
      "city": "Lausanne",
      "postalCode": "1000",
      "region": "Vaud",
      "country": "CH",
      "lat": 46.5197,
      "lng": 6.6323,
      "isOpen": true,
      "instagramHandle": "buvettedulaclausanne",
      "updatedAt": "2025-06-01T12:34:56.000Z"
    }
  ]
}

GET/api/v1/buvettes/{slug}Single buvette

Returns a single buvette by its slug. Returns 404 if not found.

{
  "buvette": {
    "id": "a1b2c3d4-...",
    "name": "Buvette du Lac",
    "slug": "buvette-du-lac",
    ...
  }
}

Response fields

idUUID

string

nameDisplay name

string

slugURL-safe identifier

string

description

string | null

addressStreet address

string | null

city

string | null

postalCode

string | null

regionCanton / region

string | null

countryISO code, e.g. CH

string | null

latWGS 84 latitude

number | null

lngWGS 84 longitude

number | null

isOpenCurrent open/closed status

boolean

instagramHandleWithout @

string | null

updatedAtISO 8601 timestamp

string

Caching

All responses include Cache-Control: public, max-age=60, stale-while-revalidate=300. Data is fresh within 60 seconds and served stale for up to 5 minutes while revalidating.