{"openapi":"3.1.0","info":{"title":"Discount Tire API (Bowmark)","version":"e833508f87ff","description":"America's largest independent tire and wheel retailer — which tires and wheels actually fit a given vehicle, what they cost, whether they are in stock near a ZIP, when a store can install them, and the rebates running on them. Three functions are built: `getProduct` reads one tire or wheel by its sku (name, brand, size, product type, price, product URL), `checkStock` answers whether a specific tire or wheel is gettable near a ZIP, store or coordinate, and on what date, and `searchTiresBySize` searches the tires Discount Tire sells in a given size (or staggered pair) with prices, ratings and the site's pagination. The other twelve are declared stubs.\n\nEvery function Bowmark has for Discount Tire (discounttire.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/discounttire/getProduct":{"post":{"operationId":"getProduct","summary":"Reads one tire or wheel product by its sku — name, brand, size, product type, product URL, and price (value and formatted string).","description":"Reads one tire or wheel product by its sku — name, brand, size, product type, product URL, and price (value and formatted string). Takes the numeric sku the site's product URLs end in (/p/<code>), or such a URL. Price is global across stores (verified at three AZ stores on the same sku on the same day, 2026-08-07), so this function takes no storeCode even though the underlying `productByCode` operation requires one — the requirement is a schema compliance constraint, not a per-caller choice. Throws on the site's all-null not-found row, so a delisted sku surfaces as an error rather than as a row whose every field is null.\n\nCalls `bowmark.providers.discounttire.getProduct`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DiscounttireProduct>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"idOrUrl":{"type":"string","description":"TypeScript: `string`"}},"required":["idOrUrl"],"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/discounttire/checkStock":{"post":{"operationId":"checkStock","summary":"Answers whether one specific tire or wheel is actually gettable near a place, and when — the site's own availability sentence for the store it resolves to (\"Available as soon as Wednesday, Aug.","description":"Answers whether one specific tire or wheel is actually gettable near a place, and when — the site's own availability sentence for the store it resolves to (\"Available as soon as Wednesday, Aug. 5\", \"Product has been discontinued\"), the ISO date behind it, the store's address and phone, the other stores around that point with distances, and the site's own pick of a better nearby store. Takes the numeric sku the site's product URLs end in (/p/<code>), or such a URL. Location is a 5-digit US zip, an exact store code, or a coordinate — never a default, because the only location the site infers is the requesting IP's. Availability at Discount Tire is regional rather than per-shelf, so read `availability.message` and `availableDate` for \"can I get it\" and treat `storeQuantity` as \"on the shelf right now\".\n\nCalls `bowmark.providers.discounttire.checkStock`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DiscounttireStock>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"idOrUrl":{"type":"string","description":"TypeScript: `string`"},"location":{"anyOf":[{"type":"object","properties":{"zip":{"type":"string"}},"required":["zip"],"additionalProperties":true},{"type":"object","properties":{"storeCode":{"type":"string"}},"required":["storeCode"],"additionalProperties":true},{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"required":["latitude","longitude"],"additionalProperties":true}],"description":"TypeScript: `{ zip: string } | { storeCode: string } | { latitude: number; longitude: number }`"}},"required":["idOrUrl","location"],"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/discounttire/searchTiresBySize":{"post":{"operationId":"searchTiresBySize","summary":"Searches the tires Discount Tire sells in a given size (or staggered pair — `front` and a different `rear`) and returns what is in stock near a place with prices and star ratings.","description":"Searches the tires Discount Tire sells in a given size (or staggered pair — `front` and a different `rear`) and returns what is in stock near a place with prices and star ratings. `front` and `rear` are stamped-on-the-sidewall sizes like `{ diameter: \"17\", width: \"225\", aspectRatio: \"45\" }` for `225/45R17`; the site's schema refuses any unknown field on a `TireSizeInput`, so the function does too. `location` is a 5-digit US zip, an exact store code, or a coordinate — same three forms `checkStock` takes, same resolution path (zip is geocoded to its centroid first, then the resolved store is the one the GraphQL operation is anchored to). `pageNumber` and `pageSize` paginate the result set (pageSize capped at 100). Returns pagination, the site's own facet list, and a list of tire rows. No `vehicleAssemblyId` is needed — unlike the by-vehicle searches here, the by-size operations take `vehicleInfo` as optional and the function never asks for one.\n\nCalls `bowmark.providers.discounttire.searchTiresBySize`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DiscounttireTireSizeSearch>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"front":{"type":"object","properties":{"diameter":{"type":"string"},"width":{"type":"string"},"aspectRatio":{"type":"string"}},"required":["diameter","width","aspectRatio"],"additionalProperties":true},"rear":{"type":"object","properties":{"diameter":{"type":"string"},"width":{"type":"string"},"aspectRatio":{"type":"string"}},"required":["diameter","width","aspectRatio"],"additionalProperties":true},"location":{"anyOf":[{"type":"object","properties":{"zip":{"type":"string"}},"required":["zip"],"additionalProperties":true},{"type":"object","properties":{"storeCode":{"type":"string"}},"required":["storeCode"],"additionalProperties":true},{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"required":["latitude","longitude"],"additionalProperties":true}]},"pageNumber":{"type":"number"},"pageSize":{"type":"number"}},"required":["front","location","pageNumber","pageSize"],"additionalProperties":true,"description":"TypeScript: `{ front: { diameter: string; width: string; aspectRatio: string }; rear?: { diameter: string; width: string; aspectRatio: string }; location: { zip: string } | { storeCode: string } | { latitude: number; longitude: number }; pageNumber: number; pageSize: number }`"}},"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}}}}}}