{
  "openapi": "3.0.1",
  "info": {
    "title": "US Alcohol License Feed — Colorado + Missouri",
    "description": "Current or newly approved liquor licenses from Colorado and Missouri in one schema (bars, restaurants, liquor stores, breweries, wineries, distributors). Filter by name, license type, city, ZIP, county or date. No contact names or phones; street addresses off by default.",
    "version": "0.1",
    "x-build-id": "iXi6oQsKsRaDImehg"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/pennant~us-alcohol-licenses/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-pennant-us-alcohol-licenses",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/pennant~us-alcohol-licenses/runs": {
      "post": {
        "operationId": "runs-sync-pennant-us-alcohol-licenses",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/pennant~us-alcohol-licenses/run-sync": {
      "post": {
        "operationId": "run-sync-pennant-us-alcohol-licenses",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "mode": {
            "title": "Feed",
            "enum": [
              "newApprovals",
              "active"
            ],
            "type": "string",
            "description": "\"New approvals\" = Colorado recently approved licenses (htyp-tqzh) + Missouri new liquor licenses for the past ~3 weeks (dymb-xy5c). \"Current licenses\" = all active licenses (Colorado ier5-5ms2 + Missouri yyhn-562y).",
            "default": "newApprovals"
          },
          "states": {
            "title": "States",
            "type": "array",
            "description": "States to include.",
            "items": {
              "type": "string",
              "enum": [
                "CO",
                "MO"
              ],
              "enumTitles": [
                "Colorado",
                "Missouri"
              ]
            },
            "default": [
              "CO",
              "MO"
            ]
          },
          "nameContains": {
            "title": "Name contains",
            "type": "string",
            "description": "Case-insensitive substring of the licensee or DBA (trade) name."
          },
          "licenseTypeContains": {
            "title": "License type contains",
            "type": "array",
            "description": "Case-insensitive substrings of the license type, any match, e.g. Brew, Winery, Restaurant, Tavern, Retail Liquor Store, Original Package, By Drink, Solicitor, Wholesale.",
            "items": {
              "type": "string"
            }
          },
          "cities": {
            "title": "Cities",
            "type": "array",
            "description": "Exact city names, case-insensitive.",
            "items": {
              "type": "string"
            }
          },
          "zipCodes": {
            "title": "ZIP codes",
            "type": "array",
            "description": "5-digit ZIPs.",
            "items": {
              "type": "string"
            }
          },
          "counties": {
            "title": "Counties (Missouri)",
            "type": "array",
            "description": "Missouri county names (prefix match, e.g. BOONE, ST. LOUIS). Colorado datasets do not publish a county, so this filter applies to Missouri only.",
            "items": {
              "type": "string"
            }
          },
          "inStateOnly": {
            "title": "In-state premises only",
            "type": "boolean",
            "description": "Skip out-of-state licensees (direct shippers, solicitors, suppliers).",
            "default": false
          },
          "dateFrom": {
            "title": "Approved on or after",
            "type": "string",
            "description": "YYYY-MM-DD. New approvals only."
          },
          "dateTo": {
            "title": "Approved on or before",
            "type": "string",
            "description": "YYYY-MM-DD. New approvals only. Defaults to today (a source date in the future is treated as an error)."
          },
          "entitiesOnly": {
            "title": "Registered businesses only",
            "type": "boolean",
            "description": "Skip licensees listed only under a personal name, sole proprietors and person-only records (manager permits, person master files); hide the licensee name when a person trades under a business-style DBA. Turn off to get every license as published.",
            "default": true
          },
          "excludeSpecialPermits": {
            "title": "Skip Missouri special permits",
            "type": "boolean",
            "description": "New approvals only. Missouri's new-licenses listing also publishes special permits and permissions (e.g. \"Permission - Employ Minors\", \"Permission - Central Warehouse\", license numbers starting with SP). They are not new liquor licenses, so they are skipped by default; turn off to include them. Add-on privileges such as Sunday sales, tastings, extended hours and caterer licenses are kept. Has no effect on Colorado or on \"All current licenses\".",
            "default": true
          },
          "sort": {
            "title": "Sort (within each state)",
            "enum": [
              "date",
              "name",
              "license"
            ],
            "type": "string",
            "description": "Default: date for new approvals, name for current licenses."
          },
          "maxItemsPerState": {
            "title": "Max results per state",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Cap per state.",
            "default": 100
          },
          "maxItems": {
            "title": "Max results total",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Run-wide cap (each result is one billable event).",
            "default": 200
          },
          "includeStreetAddress": {
            "title": "Include street address and map point",
            "type": "boolean",
            "description": "If on, street lines (and the Colorado latitude/longitude) are returned; otherwise only city, state, ZIP and county.",
            "default": false
          },
          "requestDelayMs": {
            "title": "Delay between pages (ms)",
            "minimum": 1000,
            "type": "integer",
            "description": "Politeness delay between API pages (robots.txt Crawl-delay: 1).",
            "default": 1100
          },
          "maxRetries": {
            "title": "Max retries per request",
            "minimum": 0,
            "maximum": 8,
            "type": "integer",
            "description": "Retries on timeouts, HTTP 408/429/5xx with exponential backoff and Retry-After.",
            "default": 4
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}