latestOpenAPI 3.1.02026-08-105025.1 KB

570ed1487f49

Endpoints

List breweries.

Returns a paginated list of breweries based on optional filters and sorting.

get/v1/breweries

Request body

per_pageinteger

Must be at least 1. Must not be greater than 200.

pageinteger

Must be at least 1.

sortstring
by_citystring

Must be at least 3 characters. Must not be greater than 255 characters.

by_countrystring

Must be at least 3 characters. Must not be greater than 255 characters.

by_diststring
by_dist_radiusnumber

Must be at least 0.1. Must not be greater than 10000.

by_dist_unit'km' | 'mi'
by_idsstring

Must be at least 3 characters. Must not be greater than 255 characters.

by_namestring

Must be at least 3 characters. Must not be greater than 255 characters.

by_postalstring

Must be at least 3 characters. Must not be greater than 255 characters.

by_statestring

Must be at least 3 characters. Must not be greater than 255 characters.

by_typestring
exclude_typesstring

Example request

{
  "per_page": 1,
  "page": 22,
  "sort": "architecto",
  "by_city": "n",
  "by_country": "g",
  "by_dist": "architecto",
  "by_dist_radius": 22,
  "by_dist_unit": "mi",
  "by_ids": "g",
  "by_name": "z",
  "by_postal": "m",
  "by_state": "i",
  "by_type": "architecto",
  "exclude_types": "architecto"
}