---
title: "One bar and its prices"
method: GET
path: "/api/v1/venues/{id}"
tags: ["public"]
---

# One bar and its prices

`GET /api/v1/venues/{id}`

## Request

- Base URL: `https://cervejabarata.com.br`
- URL: `https://cervejabarata.com.br/api/v1/venues/{id}`
- Auth: none declared

The bar's details and every price it has inside the rankings. Ids come from the static venue files.

## Path parameters

- `id` integer, required

## Query parameters

- `lang` 'pt-BR' | 'en': Language of labels, schedules and page links

## Response `200`

The bar

- VenueResponse
  - `city` string, required
  - `city_url` string, required
  - `as_of` string, required
  - `count` integer, required
  - `deals` PublicDeal[], required
    - `venue` string, required
    - `neighbourhood` string, nullable, required
    - `url` string, required: The bar's page on cervejabarata.com.br, to cite
    - `beer` string, required
    - `brand` string, nullable, required
    - `serving` string, required: e.g. "Garrafa 600 ml" or "Balde: 5 × Long neck 330 ml"
    - `format` string, required
    - `price_brl` number, required
    - `price_per_litre_brl` number: Absent for open bars
    - `open_bar_minutes` integer, nullable
    - `price_label` string, required
    - `kind` 'regular' | 'happy_hour' | 'promo' | 'combo' | 'open_bar', required
    - `when` string, nullable, required: Happy hours and timed promos, e.g. "seg–sex 17h–20h"
    - `service_charge_pct` integer, nullable, required
    - `couvert_brl` number, nullable, required
    - `conditions` string, nullable, required
    - `verified_on` string, required: City-local date of the last check
    - `possibly_out_of_date` boolean, required: Last checked more than 90 days ago
    - `confirmations` integer, required
    - `distance_m` integer: Only from /cheapest with lat and lng
  - `source` string, required: Attribution: Cerveja Barata (cervejabarata.com.br), ODbL
  - `venue` PublicVenue, required
    - `name` string, required
    - `url` string, nullable, required: The bar's page, once it has a price
    - `kind` string, required
    - `drink_on_site` boolean, required
    - `neighbourhood` string, nullable, required
    - `address` string, nullable, required
    - `lat` number, required
    - `lng` number, required
    - `instagram` string, nullable, required
    - `opening_hours` string, nullable, required
    - `attributes` string[], required

## Other responses

- `400`: Invalid query
- `404`: Unknown city or bar
- `429`: Too many requests
- `503`: Degraded mode: use the static datasets

---

[API](https://skmtc.dev/cervejabarata/apis/cerveja-barata-public-api.md) · [All operations](https://skmtc.dev/cervejabarata/apis/cerveja-barata-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cervejabarata/apis/cerveja-barata-public-api/revisions/19a783be3c18?raw)