Open Brewery DB · Schema

Brewery

A brewery, cidery, brewpub, or bottleshop record from Open Brewery DB.

BeerBottle ShopsBrew PubsBreweriesCider

Properties

Name Type Description
id string Unique identifier for the brewery (Open Brewery DB ID).
name string Name of the brewery.
brewery_type string Type classification of the brewery.
address_1 stringnull Primary street address.
address_2 stringnull Secondary address line.
address_3 stringnull Tertiary address line.
city string City where the brewery is located.
state_province stringnull State or province (preferred; replaces deprecated state field).
postal_code stringnull Postal or ZIP code.
country string Country where the brewery is located.
longitude numbernull Longitude coordinate (WGS84 decimal degrees).
latitude numbernull Latitude coordinate (WGS84 decimal degrees).
phone stringnull Phone number (format varies by country).
website_url stringnull Website URL of the brewery.
state stringnull Deprecated. Use state_province instead.
street stringnull Deprecated. Use address_1 instead.
View JSON Schema on GitHub

JSON Schema

brewery.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/open-brewery-db/main/json-schema/brewery.json",
  "title": "Brewery",
  "description": "A brewery, cidery, brewpub, or bottleshop record from Open Brewery DB.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "description": "Unique identifier for the brewery (Open Brewery DB ID).",
      "examples": ["ae7b3174-8be8-4d53-a3a5-9b8240970eea"]
    },
    "name": {
      "type": "string",
      "description": "Name of the brewery.",
      "examples": ["Dogfish Head Craft Brewery"]
    },
    "brewery_type": {
      "type": "string",
      "description": "Type classification of the brewery.",
      "enum": [
        "micro",
        "nano",
        "regional",
        "brewpub",
        "large",
        "planning",
        "bar",
        "contract",
        "proprietor",
        "taproom",
        "cidery",
        "closed"
      ],
      "examples": ["micro"]
    },
    "address_1": {
      "type": ["string", "null"],
      "description": "Primary street address.",
      "examples": ["6 Cannery Village Center"]
    },
    "address_2": {
      "type": ["string", "null"],
      "description": "Secondary address line.",
      "examples": [null]
    },
    "address_3": {
      "type": ["string", "null"],
      "description": "Tertiary address line.",
      "examples": [null]
    },
    "city": {
      "type": "string",
      "description": "City where the brewery is located.",
      "examples": ["Milton"]
    },
    "state_province": {
      "type": ["string", "null"],
      "description": "State or province (preferred; replaces deprecated state field).",
      "examples": ["Delaware"]
    },
    "postal_code": {
      "type": ["string", "null"],
      "description": "Postal or ZIP code.",
      "examples": ["19968-1674"]
    },
    "country": {
      "type": "string",
      "description": "Country where the brewery is located.",
      "examples": ["United States"]
    },
    "longitude": {
      "type": ["number", "null"],
      "description": "Longitude coordinate (WGS84 decimal degrees).",
      "examples": [-75.1241]
    },
    "latitude": {
      "type": ["number", "null"],
      "description": "Latitude coordinate (WGS84 decimal degrees).",
      "examples": [38.9974]
    },
    "phone": {
      "type": ["string", "null"],
      "description": "Phone number (format varies by country).",
      "examples": ["3026843156"]
    },
    "website_url": {
      "type": ["string", "null"],
      "format": "uri",
      "description": "Website URL of the brewery.",
      "examples": ["https://www.dogfish.com"]
    },
    "state": {
      "type": ["string", "null"],
      "deprecated": true,
      "description": "Deprecated. Use state_province instead.",
      "examples": ["Delaware"]
    },
    "street": {
      "type": ["string", "null"],
      "deprecated": true,
      "description": "Deprecated. Use address_1 instead.",
      "examples": ["6 Cannery Village Center"]
    }
  },
  "required": ["id", "name", "brewery_type", "city", "country"]
}