{"openapi":"3.1.0","info":{"title":"Pizza Hut API (Bowmark)","version":"e833508f87ff","description":"Pizza Hut's US ordering site. `findStores` returns the stores serving any US address or ZIP, nearest first, with each one's number, hours, distance, phone and the terms of the carryout and delivery it offers. `getMenu` reads a store's whole menu — every category, every item, and every variant's price at THAT store. `getMenuItem` reads one item's full store-level configuration by name — every size/crust, and every optional topping/sauce/cheese slot with what each choice costs on THAT variant. `getDeals` reads the deals and bundle offers Pizza Hut is running AT ONE STORE right now, filtered to what is actually redeemable there. `priceOrder` then prices a basket at one of those stores WITHOUT placing it — line items, subtotal, sales tax, delivery fee and the real total Pizza Hut would charge, for carryout or to a delivery address, anonymously.\n\nEvery function Bowmark has for Pizza Hut (pizzahut.com) as one HTTP call. Each runs on Bowmark's infrastructure with the same billing, rules and response envelope as `POST /v1/run`. The whole API: https://api.bowmark.ai/openapi.json. Guide: https://bowmark.ai/docs/api.","contact":{"email":"support@bowmark.ai","url":"https://bowmark.ai/docs/api"}},"servers":[{"url":"https://api.bowmark.ai"}],"security":[{"bearer":[]},{"apiKeyHeader":[]}],"paths":{"/v1/sites/pizzahut/getMenu":{"post":{"operationId":"getMenu","summary":"Reads a store's whole menu — every category (pizza, wings, pasta, sides, desserts, drinks, dips, melts, …), every item in each, and each item's variants with their price AT THAT STORE, all in cents.","description":"Reads a store's whole menu — every category (pizza, wings, pasta, sides, desserts, drinks, dips, melts, …), every item in each, and each item's variants with their price AT THAT STORE, all in cents. `storeNumber` comes from `findStores` and is required because Pizza Hut's prices are store-level — measured 2026-08-07, the same Pepperoni Pizza was $5.50 / $20.08 at store 026196 (North Hollywood CA) and $6.69 / $12.99 at store 027278 (Plano TX), all 11 variants differing between the two, so omitting the store would silently return whatever default the site happens to serve. One GraphQL read returns the whole menu in a single ~200 KB response (measured 2026-08-07 on store 026196: 20 categories, 138 items, 731 variants, 731/731 with prices), so no fan-out is needed. Bundle items and bare-variant category items are out of scope — they are not configurable products — same exclusion as `flattenProductCatalog`. A variant is the priced configuration (size + crust already in `variantCode`), so a `variantCode` read here plus a `slotCode` / `modifierCode` / `modifierWeightCode` triple from `getMenuItem` is everything `priceOrder` needs to price a configured basket. Wholly anonymous: no account, no session, no identity of any kind, same guest-token read `priceOrder` and `getMenuItem` use.\n\nCalls `bowmark.providers.pizzahut.getMenu`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<PizzahutMenu>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"storeNumber":{"type":"string"}},"required":["storeNumber"],"additionalProperties":true,"description":"TypeScript: `{ storeNumber: string }`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/pizzahut/findStores":{"post":{"operationId":"findStores","summary":"Finds the Pizza Hut stores that serve a US location — each store's number, street address, phone, opening hours, straight-line distance, online status, and the terms of every fulfillment type it offer","description":"Finds the Pizza Hut stores that serve a US location — each store's number, street address, phone, opening hours, straight-line distance, online status, and the terms of every fulfillment type it offers (carryout and/or delivery, each with its promise time and order minimum in cents, plus the store's base delivery fee). Results come back NEAREST FIRST. `where` takes a bare 5-digit ZIP (\"90210\") or \"City, ST\" (\"Austin, TX\"); anything else must be passed as parts — { address, city, state, zip } — because Pizza Hut answers a mis-split free-form address with a confident list of the wrong city's stores rather than an error, so this refuses to guess instead of returning one. `fulfillment` defaults to \"carryout\" and genuinely changes the answer rather than filtering it: measured 2026-08-05, carryout on 75024 returned 30 stores where delivery on a full Plano street address returned the single store that will actually deliver there. `limit` is honoured by the site (omit it for everything), and a broad search is capped at 30 by the site either way, so a metro search returns the nearest 30 and never an estate dump. A location Pizza Hut does not serve — Juneau AK 99801 — returns an empty array, which is the site's own answer and not an error, while an unreadable ZIP throws as caller-fixable. No account, no session, no identity of any kind: this is an anonymous read. Each result also carries `localizationToken`, the store-scoped JWT Pizza Hut's own site sends as its `Localization` header, which is what the rest of this provider will need to read a store's menu and prices.\n\nCalls `bowmark.providers.pizzahut.findStores`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<PizzahutStore[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"where":{"anyOf":[{"type":"string"},{"type":"object","properties":{"address":{"type":"string"},"address2":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"zip":{"type":"string"},"latitude":{"type":"number"},"longitude":{"type":"number"}},"additionalProperties":true}],"description":"TypeScript: `string | { address?: string; address2?: string; city?: string; state?: string; zip?: string; latitude?: number; longitude?: number }`"},"options":{"type":"object","properties":{"fulfillment":{"anyOf":[{"const":"carryout"},{"const":"delivery"}]},"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ fulfillment?: \"carryout\" | \"delivery\"; limit?: number }`"}},"required":["where"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/pizzahut/priceOrder":{"post":{"operationId":"priceOrder","summary":"Prices a basket at one Pizza Hut store WITHOUT placing it — every line item, the subtotal, each sales tax, each fee (the delivery fee among them) and the real total Pizza Hut would charge, all in CENT","description":"Prices a basket at one Pizza Hut store WITHOUT placing it — every line item, the subtotal, each sales tax, each fee (the delivery fee among them) and the real total Pizza Hut would charge, all in CENTS and all the site's own numbers rather than anything summed here. This is the only function that answers what an order actually costs: menu prices are per-store and per-configuration, and tax and delivery land on top. `storeNumber` comes from `findStores`; `productCode` and `variantCode` come from that store's menu, and a variant IS the priced configuration, so size and crust are already in it. `fulfillment` defaults to \"carryout\" and genuinely changes the price — only a delivery basket carries a delivery fee, and `deliveryAddress` is REQUIRED with it (measured 2026-08-05: the site prices an address-less delivery cart with an empty `fees` array, i.e. a total short by the fee, so this refuses rather than under-quote; passing an address to a carryout order is refused for the mirror reason). `requestedTime` prices an order for later, and is how you get a price at all when the store is currently shut, which Pizza Hut otherwise refuses outright. `promoCode` applies a coupon; an expired or bogus one does NOT throw — the basket comes back at full price with `PromotionNotApplied` in `siteNotes`, because a dead coupon is an answer. **This is a read and it stops dead before the checkout**: it never supplies a recipient, never supplies payment and never submits, and the site itself agrees — `blockers` names exactly what Pizza Hut still wants (`CartOrderRecipientIsNull`, plus payment), which is the boundary rather than a failure. Wholly anonymous: no account, no sign-in, no name, no phone, no email and no date of birth is sent or needed, and every call opens its own fresh guest cart so totals never accumulate across calls.\n\nCalls `bowmark.providers.pizzahut.priceOrder`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<PizzahutPricedOrder>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"order":{"type":"object","properties":{"storeNumber":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"productCode":{"type":"string"},"variantCode":{"type":"string"},"quantity":{"type":"number"},"modifiers":{"type":"array","items":{"type":"object","properties":{"slotCode":{"type":"string"},"modifierCode":{"type":"string"},"modifierWeightCode":{"type":"string"}},"required":["slotCode","modifierCode","modifierWeightCode"],"additionalProperties":true}},"specialInstructions":{"type":"string"}},"required":["productCode","variantCode"],"additionalProperties":true}},"fulfillment":{"anyOf":[{"const":"carryout"},{"const":"delivery"}]},"deliveryAddress":{"type":"object","properties":{"address":{"type":"string"},"address2":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"zip":{"type":"string"},"deliveryInstructions":{"type":"string"},"phone":{"type":"string"}},"required":["address","city","state","zip"],"additionalProperties":true},"requestedTime":{"type":"string"},"promoCode":{"type":"string"}},"required":["storeNumber","items"],"additionalProperties":true,"description":"TypeScript: `{ storeNumber: string; items: { productCode: string; variantCode: string; quantity?: number; modifiers?: { slotCode: string; modifierCode: string; modifierWeightCode: string }[]; specialInstructions?: string }[]; fulfillment?: \"carryout\" | \"delivery\"; deliveryAddress?: { address: string; address2?: string; city: string; state: string; zip: string; deliveryInstructions?: string; phone?: string }; requestedTime?: string; promoCode?: string }`"}},"required":["order"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/pizzahut/getMenuItem":{"post":{"operationId":"getMenuItem","summary":"Reads one menu item in full for a store — every size/crust it comes in, each one's own starting price, and every optional slot (sauce, cheese, toppings, seasoning, cut) with what each choice costs ON ","description":"Reads one menu item in full for a store — every size/crust it comes in, each one's own starting price, and every optional slot (sauce, cheese, toppings, seasoning, cut) with what each choice costs ON THAT VARIANT, plus nutrition serving size and allergens where the site publishes them. `storeNumber` comes from `findStores`. `getMenu` (the sibling function that would normally hand out a `productCode` to browse by) is still a stub, so `item` is a NAME instead — \"Pepperoni Pizza\" — matched first as an exact `productCode` if you already have one, then an exact case-insensitive name, then a substring; `category` (a code like \"pizza\" or a display name like \"Pizza\") narrows the search when a name alone is ambiguous. Zero matches or more than one both throw as caller-fixable, the second one listing every candidate's name, category and `productCode` so a retry can pick one exactly. **Configuration prices are per VARIANT, not per product** — measured 2026-08-06 on the same Pepperoni Pizza, Extra Cheese is +$0.50 on a Personal Pan, +$2.89 on a Medium, +$3.39 on a Large, so this returns each variant's own priced slot tree rather than one flat add-on price for the whole item. A `variantCode` plus a `slotCode`/`modifierCode`/`modifierWeightCode` triple read here is exactly what `priceOrder` takes to price a configured basket. Wholly anonymous, same guest-token read `priceOrder` uses — no account, no session, nothing identifying.\n\nCalls `bowmark.providers.pizzahut.getMenuItem`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<PizzahutMenuItem>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"storeNumber":{"type":"string"},"item":{"type":"string"},"category":{"type":"string"}},"required":["storeNumber","item"],"additionalProperties":true,"description":"TypeScript: `{ storeNumber: string; item: string; category?: string }`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/pizzahut/getDeals":{"post":{"operationId":"getDeals","summary":"Reads the deals, coupons and bundle offers Pizza Hut is running AT ONE STORE right now — every deal that applies there, its bundle code, display name, description and legal text, in the order the site","description":"Reads the deals, coupons and bundle offers Pizza Hut is running AT ONE STORE right now — every deal that applies there, its bundle code, display name, description and legal text, in the order the site puts them on the deals page. `storeNumber` comes from `findStores` and is REQUIRED: Pizza Hut runs national deals AND franchise-local ones, and a deal listed but not available at the caller's store is the honest-vs-misleading line — the function filters by `MenuDealPageSortOverride.storesList` (a comma-separated list of stores, or the literal \"ALL\") so a caller gets only what is actually redeemable where they asked. The store's deals page lives on Contentful (NOT the Yum storefront GraphQL the rest of the provider hits): the deals page's own `__NEXT_DATA__.runtimeConfig` publishes `CONTENTFUL_SPACE_ID` + `CONTENTFUL_ACCESS_TOKEN` + `CONTENTFUL_ENVIRONMENT` + `CONTENTFUL_BASE_URL`, and this reads them out of the page rather than asking the caller for them. The bootstrap throws on a missing payload the way `parsePhdConfig` does — a 200 without the runtimeConfig is the Canadian site, and serving a caller the wrong country’s deals is worse than no answer. The list is sorted by `dealPagePosition` (1-based, lower = higher up); positions the site leaves null fall back to a stable code-order tiebreak rather than being treated as \"first\". Wholly anonymous, one Contentful read per call.\n\nCalls `bowmark.providers.pizzahut.getDeals`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<PizzahutDealsForRender>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"storeNumber":{"type":"string"}},"required":["storeNumber"],"additionalProperties":true,"description":"TypeScript: `{ storeNumber: string }`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Your Bowmark API key."},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-Bowmark-Key"}},"responses":{"NotFound":{"description":"No such site or function.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}},"schemas":{"RunEnvelope":{"type":"object","description":"What a run returns. `status` says whether the SCRIPT succeeded. A script that threw or paused for a login is still HTTP 200. Branch on `status`, not on the HTTP code.","required":["ok","status","result","logs","error","ms"],"properties":{"runId":{"type":"string","description":"Stable id for this run. Quote it in a support or `report` message."},"ok":{"type":"boolean","description":"False only when the run produced nothing usable."},"status":{"type":"string","enum":["ok","error","partial","needs_user"],"description":"`partial`: the result is real but some calls failed (see `incomplete`); `ok` stays true. `needs_user`: a person must sign in to a site first. Relay `meta.handoff.url` to them, then run again."},"egress":{"type":"string","enum":["default","link"],"description":"The egress the run was given, present only when the request asked for one. `link`: every request went through the caller's own Chrome (Bowmark Buddy)."},"result":{"description":"Whatever the script `return`ed. Any JSON value."},"logs":{"type":"array","items":{"type":"string"},"description":"Lines the script wrote with `log(...)`."},"error":{"type":["string","null"],"description":"Why the run failed, in plain words. Null on success."},"ms":{"type":"integer","description":"How long the script itself ran, in milliseconds."},"queuedMs":{"type":"integer","description":"How long the run waited for a worker before starting. Present only when it was a second or more."},"needs":{"type":"array","description":"The sign-ins this script is waiting on. Present when `status` is `needs_user`.","items":{"type":"object","required":["capability","provider","providerTitle","kind"],"properties":{"capability":{"type":"string"},"provider":{"type":"string"},"providerTitle":{"type":"string","description":"The site's name, to show a person."},"kind":{"type":"string"}}}},"incomplete":{"type":"object","description":"Present only when `status` is `partial`: which calls did not answer.","properties":{"summary":{"type":"string"},"totalCalls":{"type":"integer"}},"additionalProperties":true},"emptyHanded":{"type":"object","description":"Present when the script returned nothing while its calls returned rows, usually a filter that matched none of the site's own labels. Lists the label values the calls actually returned.","additionalProperties":true},"notes":{"type":"array","description":"Caveats a call attached to a complete answer. Never changes `status`.","items":{"type":"object","properties":{"path":{"type":"string"},"notes":{"type":"array","items":{"type":"string"}}}}},"meta":{"type":"object","properties":{"handoff":{"type":"object","description":"A single-use sign-in link for a person to open. Expires at `expiresAt`.","properties":{"ref":{"type":"string"},"url":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time"}}},"concurrency":{"type":"object","description":"On a 429: how many runs are in flight and when to retry.","properties":{"limit":{"type":"integer"},"inFlight":{"type":"integer"},"retryAfterSeconds":{"type":"integer"}}}},"additionalProperties":true},"notice":{"type":"object","description":"Set when the account owner has not accepted the current Terms. Relay it to them.","additionalProperties":true}}}}}}