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.

{
    "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.

[
    {
        "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"
    }
]

Last updated