# Random

## Returns one or more random breweries from the database.

<mark style="color:blue;">`GET`</mark> `https://api.openbrewerydb.org/breweries/random`

#### Path Parameters

| Name | Type    | Description                                                                         |
| ---- | ------- | ----------------------------------------------------------------------------------- |
| size | Integer | The number of breweries to return with each call. Default is 1, max per page is 50. |

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

```json
[
    {
        "id": "big-tupper-brewing-tupper-lake",
        "name": "Big Tupper Brewing",
        "brewery_type": "brewpub",
        "street": "12 Cliff Ave",
        "address_2": null,
        "address_3": null,
        "city": "Tupper Lake",
        "state": "New York",
        "county_province": null,
        "postal_code": "12986-1719",
        "country": "United States",
        "longitude": "-74.46576367",
        "latitude": "44.223293",
        "phone": "5183596350",
        "website_url": "http://www.bigtupperbrewing.com",
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    },
    {
        "id": "iron-horse-brewery-ellensburg",
        "name": "Iron Horse Brewery",
        "brewery_type": "regional",
        "street": "1621 Vantage Hwy",
        "address_2": null,
        "address_3": null,
        "city": "Ellensburg",
        "state": "Washington",
        "county_province": null,
        "postal_code": "98926-9001",
        "country": "United States",
        "longitude": "-120.52000035450321",
        "latitude": "47.00287945234483",
        "phone": "5099333134",
        "website_url": "http://www.ironhorsebrewery.com",
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    },
    {
        "id": "taylor-house-brewing-co-catasauqua",
        "name": "Taylor House Brewing Co",
        "brewery_type": "micro",
        "street": "76 Lehigh St",
        "address_2": null,
        "address_3": null,
        "city": "Catasauqua",
        "state": "Pennsylvania",
        "county_province": null,
        "postal_code": "18032",
        "country": "United States",
        "longitude": "-75.46805342",
        "latitude": "40.64817832",
        "phone": null,
        "website_url": "http://www.taylorhousebrewing.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>

`https://api.openbrewerydb.org/breweries/random?size=3`

```json
[
    {
        "id": "big-tupper-brewing-tupper-lake",
        "name": "Big Tupper Brewing",
        "brewery_type": "brewpub",
        "street": "12 Cliff Ave",
        "address_2": null,
        "address_3": null,
        "city": "Tupper Lake",
        "state": "New York",
        "county_province": null,
        "postal_code": "12986-1719",
        "country": "United States",
        "longitude": "-74.46576367",
        "latitude": "44.223293",
        "phone": "5183596350",
        "website_url": "http://www.bigtupperbrewing.com",
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    },
    {
        "id": "iron-horse-brewery-ellensburg",
        "name": "Iron Horse Brewery",
        "brewery_type": "regional",
        "street": "1621 Vantage Hwy",
        "address_2": null,
        "address_3": null,
        "city": "Ellensburg",
        "state": "Washington",
        "county_province": null,
        "postal_code": "98926-9001",
        "country": "United States",
        "longitude": "-120.52000035450321",
        "latitude": "47.00287945234483",
        "phone": "5099333134",
        "website_url": "http://www.ironhorsebrewery.com",
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    },
    {
        "id": "taylor-house-brewing-co-catasauqua",
        "name": "Taylor House Brewing Co",
        "brewery_type": "micro",
        "street": "76 Lehigh St",
        "address_2": null,
        "address_3": null,
        "city": "Catasauqua",
        "state": "Pennsylvania",
        "county_province": null,
        "postal_code": "18032",
        "country": "United States",
        "longitude": "-75.46805342",
        "latitude": "40.64817832",
        "phone": null,
        "website_url": "http://www.taylorhousebrewing.com",
        "updated_at": "2022-08-20T02:56:08.975Z",
        "created_at": "2022-08-20T02:56:08.975Z"
    }
]json
```

</details>
