{"openapi":"3.1.0","info":{"title":"Dillard's API (Bowmark)","version":"e833508f87ff","description":"Dillard's department store catalog, store-level stock, store locator and wedding/gift registry search.\n\nEvery function Bowmark has for Dillard's (dillards.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/dillards/search":{"post":{"operationId":"search","summary":"Searches dillards.com's catalog for a keyword and returns the matching products the site puts on its own first results page — brand-prefixed name, brand, current price range, pre-markdown `listPrice` ","description":"Searches dillards.com's catalog for a keyword and returns the matching products the site puts on its own first results page — brand-prefixed name, brand, current price range, pre-markdown `listPrice` and the site's own `onSale` flag, the item number a shopper sees (`id`), the id the product URL is keyed on (`catentryId`), a full-size image, star rating and review count, and `colorCount`, how many colourways the grid shows. **`totalCount` is the site's own match total and is routinely far larger than the rows returned** — a search for \"dress\" reports 8,324 matches and serves 96 — because Dillard's publishes NO paging parameter anywhere in the page (`?page=2` was measured and returns page 1 again), so the remaining pages are not reachable from here and this function does not pretend otherwise. **There is no size data on the search grid**; `colorCount` counts colourways only, and sizes live on the product page. Pass `department` to scope the search to a department slug published in a previous result's own nav (\"shoes\", \"kids\", or a deeper \"shoes-kids-shoes-girls-shoes\") — a department the site does not recognise THROWS and names the ones it does offer for that query, because the site's own behaviour is to silently ignore an unknown department and return the UNFILTERED catalog, which would otherwise reach a caller as a successful filter. A query that genuinely matches nothing returns `[]`; a page that answers but has lost its product data THROWS rather than reporting the outage as zero hits.\n\nCalls `bowmark.providers.dillards.search`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<dillardsRow[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/dillardsSearchQuery","description":"TypeScript: `dillardsSearchQuery`"}},"required":["query"],"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/dillards/checkStock":{"post":{"operationId":"checkStock","summary":"Answers whether one exact size/color of a product is available right now — both for shipping (the site's own online availability) and for pickup at ONE named store — the way dillards.com's own \"Find I","description":"Answers whether one exact size/color of a product is available right now — both for shipping (the site's own online availability) and for pickup at ONE named store — the way dillards.com's own \"Find In Store\" button does. Pass `url` (a product page URL, exactly as `search` returns it), `size` and `color` (exactly as the product page publishes them — an unmatched combination THROWS and lists every one the product actually offers, the same pattern `search` uses for an unrecognised `department`) and `store` (Dillard's own store number, e.g. \"0153\"). Returns the site's own `sku` for that size/color, `onHand` (units physically on the shelf at that store right now), `inStoreStock` (`onHand > 0`), `carriedByStore` (whether the store's inventory system stocks this sku at all) and `shipsOnline` (the site's own online-availability flag for the same size/color, independent of any store). **`carriedByStore` cannot tell a real store that never stocks this item apart from a store NUMBER the site does not recognise** — measured 2026-08-04, dillards.com's inventory endpoint answers an unknown store id with the identical all-zero shape it gives a real, non-stocking one, so a caller must already have a genuine Dillard's store number.\n\nCalls `bowmark.providers.dillards.checkStock`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<dillardsStockResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/dillardsCheckStockQuery","description":"TypeScript: `dillardsCheckStockQuery`"}},"required":["query"],"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/dillards/getProduct":{"post":{"operationId":"getProduct","summary":"Reads one product's own page — full name, brand, description, primary image plus every gallery shot, current price range, pre-markdown `listPrice` and the site's own `onSale` flag, star rating and rev","description":"Reads one product's own page — full name, brand, description, primary image plus every gallery shot, current price range, pre-markdown `listPrice` and the site's own `onSale` flag, star rating and review count (both null/0 when the product has no reviews yet — the site omits the field entirely rather than publishing a zero), `colorCount` (distinct colourways), and `variants[]`, every size/color combination the page lists with its own sku and `shipsOnline` flag. Pass `url` exactly as `search` returns it in a row's own `url`. **This is a summary, not a store check** — `variants[].shipsOnline` is the product's own online-availability flag, independent of any physical store; whether ONE exact size/color is in stock at a named store is `checkStock`'s job, not this one's.\n\nCalls `bowmark.providers.dillards.getProduct`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<dillardsProduct>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/dillardsGetProductQuery","description":"TypeScript: `dillardsGetProductQuery`"}},"required":["query"],"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/dillards/searchRegistry":{"post":{"operationId":"searchRegistry","summary":"Searches Dillard's wedding/gift registry (dillards.com/registry) — a distinctive Dillard's feature, not a generic department-store search — and returns the matching registry's own item list with purch","description":"Searches Dillard's wedding/gift registry (dillards.com/registry) — a distinctive Dillard's feature, not a generic department-store search — and returns the matching registry's own item list with purchase status. Pass EITHER `registryNumber` (the registry's own 9-digit number, unambiguous) OR BOTH `firstName` and `lastName` together (dillards.com's own form requires the pair — a lone first or last name THROWS rather than reaching the site with a blank field). A `registryNumber` or a name resolving to exactly ONE registry returns a single-element array carrying that registry's `names`, `eventType` (\"wedding\", \"baby\", ...), `location`, `eventDate` (ISO) and every `items[]` row — `name`, `price` (null for an unconfigured gift card), `color`/`size`, `sku`/`dms`, `image`, `category` (the site's own section header, e.g. \"Not Available for Internet Purchase\", or null — most items carry none), `requestedQty`/`remainingQty`/`fulfilled` (`remainingQty === 0` — **all three are null for a gift card**, since the site tracks no quantity for one at all; treating that as `fulfilled: true` would falsely claim it was already bought), and `availableOnline` (some registry items are in-store pickup only). A name matching NOBODY returns `[]` — a real, common outcome, not an error. **A name matching 2+ registries THROWS, naming every candidate** (names, registry number, event type, location, date) so the caller can call again with the specific `registryNumber` — dillards.com itself never auto-resolves a name search to one registry, even when only one matches, so this function follows a single match through to its item page rather than handing back an unusable list.\n\nCalls `bowmark.providers.dillards.searchRegistry`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<dillardsRegistry[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/dillardsRegistrySearchQuery","description":"TypeScript: `dillardsRegistrySearchQuery`"}},"required":["query"],"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/dillards/findStores":{"post":{"operationId":"findStores","summary":"Finds nearby Dillard's store locations the way the site's own /stores locator does — every row carrying its `storeNumber` (the 4-digit id `checkStock` accepts as its `store` argument), mall/anchor `na","description":"Finds nearby Dillard's store locations the way the site's own /stores locator does — every row carrying its `storeNumber` (the 4-digit id `checkStock` accepts as its `store` argument), mall/anchor `name`, `address1`/`address2`, `city`, full `state` and 2-letter `stateCode`, 5-digit `zip`, 10-digit `phone`, the per-store detail `url`, and the site's own `latitude`/`longitude` (null when the row omits either). Pass AT LEAST ONE of `state` (full name like \"Ohio\" or 2-letter code like \"OH\" — an unknown state THROWS, naming the 30 the site publishes), `city` (exact, case-insensitive match against the site's own `city` field — a name that does not match returns `[]`), or `zip` (5-digit US ZIP, exact match — the site publishes one store per ZIP today, so this is \"the store at this ZIP\" without needing a centroid lookup). Multiple filters narrow; a `state`+`city` request is a per-state page plus a client-side city filter. Pass `limit` to trim. A query with no filters THROWS, naming every one the site supports — an empty-argument call would otherwise hand back the full 272-store list with no way to tell whether that was what the caller meant.\n\nCalls `bowmark.providers.dillards.findStores`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<dillardsStoreRow[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/dillardsFindStoresQuery","description":"TypeScript: `dillardsFindStoresQuery`"}},"required":["query"],"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}}},"dillardsCheckStockQuery":{"type":"object","properties":{"url":{"type":"string"},"size":{"type":"string"},"color":{"type":"string"},"store":{"type":"string"}},"required":["url","size","color","store"],"additionalProperties":true},"dillardsFindStoresQuery":{"type":"object","properties":{"state":{"type":"string"},"city":{"type":"string"},"zip":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true},"dillardsGetProductQuery":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"],"additionalProperties":true},"dillardsRegistrySearchQuery":{"type":"object","properties":{"firstName":{"type":"string"},"lastName":{"type":"string"},"registryNumber":{"type":"string"}},"additionalProperties":true},"dillardsSearchQuery":{"type":"object","properties":{"query":{"type":"string"},"department":{"type":"string"},"limit":{"type":"number"}},"required":["query"],"additionalProperties":true}}}}