Breweries

Get information for a specific brewery or a list of breweries by criteria.

Getting Information on a Single Brewery

Returns the entry for a specified brewery.

GET https://api.openbrewerydb.org/breweries/{obdb-id}

{obdb-id} is the brewery's ID in the database.

200: OK

{
    "id": "deschutes-brewery-bend",
    "name": "Deschutes Brewery",
    "brewery_type": "regional",
    "street": "901 SW Simpson Ave",
    "address_2": null,
    "address_3": null,
    "city": "Bend",
    "state": "Oregon",
    "county_province": null,
    "postal_code": "97702-3118",
    "country": "United States",
    "longitude": "-121.3246184",
    "latitude": "44.04780638",
    "phone": "5413858606",
    "website_url": "http://www.deschutesbrewery.com",
    "updated_at": "2022-08-20T02:56:08.975Z",
    "created_at": "2022-08-20T02:56:08.975Z"
}

Sample Request & Response

GET https://api.openbrewerydb.org/breweries/deschutes-brewery-bend

{
    "id": "deschutes-brewery-bend",
    "name": "Deschutes Brewery",
    "brewery_type": "regional",
    "street": "901 SW Simpson Ave",
    "address_2": null,
    "address_3": null,
    "city": "Bend",
    "state": "Oregon",
    "county_province": null,
    "postal_code": "97702-3118",
    "country": "United States",
    "longitude": "-121.3246184",
    "latitude": "44.04780638",
    "phone": "5413858606",
    "website_url": "http://www.deschutesbrewery.com",
    "updated_at": "2022-08-20T02:56:08.975Z",
    "created_at": "2022-08-20T02:56:08.975Z"
}

Getting a List of Breweries

Returns a list of breweries that have been filtered and sorted.

GET https://api.openbrewerydb.org/breweries

All parameters are optional. Returns the first 20 entries if no query parameters are specified.

Path Parameters

Name	Type	Description
by_city	String	Filter breweries by city.
sort	String	Sort the results by one or more fields. by_dist does not work with this query parameter. asc - Sort in ascending order desc - Sort in descending order
by_dist	String	Sort the results by distance from a specified origin point in latitude,longitude
per_page	Integer	Number of breweries to return each call. Default max per page is 20. Max per page is 50.
page	Integer	The offset or page of breweries to return.
by_type	String	Filter by type of brewery. Valid values: micro - Most craft breweries. For example, Samuel Adams is still considered a micro brewery. nano - An extremely small brewery which typically only distributes locally. regional - A regional location of an expanded brewery. Ex. Sierra Nevada’s Asheville, NC location. brewpub - A beer-focused restaurant or restaurant/bar with a brewery on-premise. large - A very large brewery. Likely not for visitors. Ex. Miller-Coors. (deprecated) planning - A brewery in planning or not yet opened to the public. bar - A bar. No brewery equipment on premise. (deprecated) contract - A brewery that uses another brewery’s equipment. proprietor - Similar to contract brewing but refers more to a brewery incubator. closed - A location which has been closed.
by_postal	String	Filter breweries by postal code. May be filtered by basic (5-digit) postal code or more precisely filtered by postal+4 (9-digit) code. Note: If filtering by postal+4 the search must include either a hyphen or an underscore.
by_state	String	Filter breweries by state.
by_name	String	Filter breweries by name.

200: OK

[
    {
        "id": "10-barrel-brewing-co-portland",
        "name": "10 Barrel Brewing Co",
        "brewery_type": "large",
        "street": "1411 NW Flanders St",
        "address_2": null,
        "address_3": null,
        "city": "Portland",
        "state": "Oregon",
        "county_province": null,
        "postal_code": "97209-2620",
        "country": "United States",
        "longitude": "-122.6855056",
        "latitude": "45.5259786",
        "phone": "5032241700",
        "website_url": "http://www.10barrel.com",
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    },
    {
        "id": "13-virtues-brewing-co-portland",
        "name": "13 Virtues Brewing Co",
        "brewery_type": "brewpub",
        "street": "6410 SE Milwaukie Ave",
        "address_2": null,
        "address_3": null,
        "city": "Portland",
        "state": "Oregon",
        "county_province": null,
        "postal_code": "97202-5518",
        "country": "United States",
        "longitude": "-122.6487531",
        "latitude": "45.4762536",
        "phone": "5032393831",
        "website_url": "http://www.13virtuesbrewing.com",
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    },
    {
        "id": "alameda-brewing-co-portland-1",
        "name": "Alameda Brewing Co",
        "brewery_type": "micro",
        "street": "4736 SE 24th Ave",
        "address_2": null,
        "address_3": null,
        "city": "Portland",
        "state": "Oregon",
        "county_province": null,
        "postal_code": "97202-4787",
        "country": "United States",
        "longitude": "-122.6412495",
        "latitude": "45.48882655",
        "phone": "5034609025",
        "website_url": null,
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    }
]

Sample Request & Response - Filtering by City and State

GET https://api.openbrewerydb.org/breweries?by_city=portland&by_state=oregon&per_page=3

[
    {
        "id": "10-barrel-brewing-co-portland",
        "name": "10 Barrel Brewing Co",
        "brewery_type": "large",
        "street": "1411 NW Flanders St",
        "address_2": null,
        "address_3": null,
        "city": "Portland",
        "state": "Oregon",
        "county_province": null,
        "postal_code": "97209-2620",
        "country": "United States",
        "longitude": "-122.6855056",
        "latitude": "45.5259786",
        "phone": "5032241700",
        "website_url": "http://www.10barrel.com",
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    },
    {
        "id": "13-virtues-brewing-co-portland",
        "name": "13 Virtues Brewing Co",
        "brewery_type": "brewpub",
        "street": "6410 SE Milwaukie Ave",
        "address_2": null,
        "address_3": null,
        "city": "Portland",
        "state": "Oregon",
        "county_province": null,
        "postal_code": "97202-5518",
        "country": "United States",
        "longitude": "-122.6487531",
        "latitude": "45.4762536",
        "phone": "5032393831",
        "website_url": "http://www.13virtuesbrewing.com",
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    },
    {
        "id": "alameda-brewing-co-portland-1",
        "name": "Alameda Brewing Co",
        "brewery_type": "micro",
        "street": "4736 SE 24th Ave",
        "address_2": null,
        "address_3": null,
        "city": "Portland",
        "state": "Oregon",
        "county_province": null,
        "postal_code": "97202-4787",
        "country": "United States",
        "longitude": "-122.6412495",
        "latitude": "45.48882655",
        "phone": "5034609025",
        "website_url": null,
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    }
]

Sample Request & Response - Sorting by Type and Name

GET https://api.openbrewerydb.org/breweries?by_state=oregon&sort=type,name:asc&per_page=3

[
    {
        "id": "1188-brewing-co-john-day",
        "name": "1188 Brewing Co",
        "brewery_type": "brewpub",
        "street": "141 E Main St",
        "address_2": null,
        "address_3": null,
        "city": "John Day",
        "state": "Oregon",
        "county_province": null,
        "postal_code": "97845-1210",
        "country": "United States",
        "longitude": "-118.9218754",
        "latitude": "44.4146563",
        "phone": "5415751188",
        "website_url": "http://www.1188brewing.com",
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    },
    {
        "id": "13-virtues-brewing-co-portland",
        "name": "13 Virtues Brewing Co",
        "brewery_type": "brewpub",
        "street": "6410 SE Milwaukie Ave",
        "address_2": null,
        "address_3": null,
        "city": "Portland",
        "state": "Oregon",
        "county_province": null,
        "postal_code": "97202-5518",
        "country": "United States",
        "longitude": "-122.6487531",
        "latitude": "45.4762536",
        "phone": "5032393831",
        "website_url": "http://www.13virtuesbrewing.com",
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    },
    {
        "id": "7-devils-brewing-co-coos-bay",
        "name": "7 Devils Brewing Co",
        "brewery_type": "brewpub",
        "street": "247 S 2nd St",
        "address_2": null,
        "address_3": null,
        "city": "Coos Bay",
        "state": "Oregon",
        "county_province": null,
        "postal_code": "97420-1642",
        "country": "United States",
        "longitude": "-124.2147508",
        "latitude": "43.36654751",
        "phone": "5418083738",
        "website_url": "http://www.7devilsbrewery.com",
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    }
]