# Breweries

## Getting Information on a Single Brewery

## Returns the entry for a specified brewery.

<mark style="color:blue;">`GET`</mark> `https://api.openbrewerydb.org/breweries/{obdb-id}`

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

{% tabs %}
{% tab title="200: OK " %}

```json
{
    "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"
}
```

{% endtab %}
{% endtabs %}

<details>

<summary>Sample Request &#x26; Response</summary>

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

```json
{
    "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"
}
```

</details>

## Getting a List of Breweries

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

<mark style="color:blue;">`GET`</mark> `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  | <p>Sort the results by one or more fields. </p><p><code>by\_dist</code> does not work with this query parameter.</p><p><code>asc</code> - Sort in ascending order </p><p><code>desc</code> - Sort in descending order</p><p></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 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  | <p>Filter by type of brewery. </p><p>Valid values:</p><p><code>micro</code> - Most craft breweries. For example, Samuel Adams is still considered a micro brewery. </p><p><code>nano</code> - An extremely small brewery which typically only distributes locally. </p><p><code>regional</code> - A regional location of an expanded brewery. Ex. Sierra Nevada’s Asheville, NC location. </p><p><code>brewpub</code> - A beer-focused restaurant or restaurant/bar with a brewery on-premise. </p><p><del><code>large</code> - A very large brewery. Likely not for visitors. Ex. Miller-Coors. (deprecated)</del> </p><p><code>planning</code> - A brewery in planning or not yet opened to the public. </p><p><del><code>bar</code> - A bar. No brewery equipment on premise. (deprecated)</del> </p><p><code>contract</code> - A brewery that uses another brewery’s equipment. </p><p><code>proprietor</code> - Similar to contract brewing but refers more to a brewery incubator.</p><p><code>closed</code> - A location which has been closed.</p> |
| by\_postal | String  | <p>Filter breweries by postal code.</p><p>May be filtered by basic (5-digit) postal code or more precisely filtered by postal+4 (9-digit) code.</p><p><strong>Note:</strong> If filtering by postal+4 the search must include either a hyphen or an underscore.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| by\_state  | String  | Filter breweries by state.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| by\_name   | String  | Filter breweries by name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

{% tabs %}
{% tab title="200: OK " %}

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

{% endtab %}
{% endtabs %}

<details>

<summary>Sample Request &#x26; Response - Filtering by City and State</summary>

`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"
    }
]
```

</details>

<details>

<summary>Sample Request &#x26; Response - Sorting by Type and Name</summary>

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

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

</details>
