{"openapi":"3.1.0","info":{"title":"Visible API (Bowmark)","version":"e833508f87ff","description":"Visible (Verizon's prepaid brand): the promotions running right now — the offer grid with its promo codes and fine print, plus the standing referral, trade-in, payback, Stack'em and Fios home-internet bundle programmes — one phone in full from its catalogue slug or URL, every storage/colour SKU with its own price, monthly financing terms and live stock, alongside the specs, images, device-protection plans and eSIM/5G support — Verizon's real network coverage at a caller-supplied US address or ZIP, broken down by 5G Ultra Wideband / 5G Nationwide / 4G LTE rather than a single yes/no — and the three-tier line-up as the plans page renders it, with each tier's headline price, the running promo and the code that unlocks it, the marketing badge and the four labelled feature sections. Also declared, not yet built: bring-your-own-device compatibility, per-device trade-in values, international rates, the wearable catalogue and the support estate.\n\nEvery function Bowmark has for Visible (visible.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/visible/listDeals":{"post":{"operationId":"listDeals","summary":"Returns the promotions Visible is running right now, read off the site's own deals page: every offer tile with its headline, what it is worth, the promo code to claim it (e.g.","description":"Returns the promotions Visible is running right now, read off the site's own deals page: every offer tile with its headline, what it is worth, the promo code to claim it (e.g. SAVE6), its fine print and where it leads — plus, unless `includePrograms: false`, each standing programme the same page enumerates (Bring a Friend's $20 referral credit, trade-in, Visible Payback, the Fios/Frontier home-internet bundle, Stack'em, gifting) with its own headline value. Reads the LIVE page only, never the site's published markdown corpus, which still serves last year's holiday offers.\n\nCalls `bowmark.providers.visible.listDeals`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<VisibleListDealsResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"options":{"type":"object","properties":{"includePrograms":{"type":"boolean"}},"additionalProperties":true,"description":"TypeScript: `{ includePrograms?: boolean }`"}},"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/visible/getPhone":{"post":{"operationId":"getPhone","summary":"Returns one phone Visible sells, at the grain a caller buys against: every storage-and-colour configuration with its own SKU, full price, current price, financed monthly payment and term, and whether ","description":"Returns one phone Visible sells, at the grain a caller buys against: every storage-and-colour configuration with its own SKU, full price, current price, financed monthly payment and term, and whether it is in stock right now — plus the colour and storage choices the page offers, the manufacturer specs, per-SKU images, the Visible Protect device-protection plans and their monthly prices, eSIM vs dual-SIM, 5G support, and trade-in/Payback/Swap eligibility. Takes the catalogue slug (\"iphone-16e\") or the visible.com product URL. Any time-boxed offer on the device is returned with its window AND a computed `active` flag, because the site's own `isFlashSaleEnabled` reads `true` on sales that ended months ago.\n\nCalls `bowmark.providers.visible.getPhone`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<VisibleGetPhoneResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slugOrUrl":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"preOwned":{"type":"boolean"}},"additionalProperties":true,"description":"TypeScript: `{ preOwned?: boolean }`"}},"required":["slugOrUrl"],"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/visible/searchPhones":{"post":{"operationId":"searchPhones","summary":"Returns the phones Visible currently sells, with the headline facts a purchase turns on — name, make, OS, list price, current price, financed monthly payment and term, in-stock status, pre-owned vs ne","description":"Returns the phones Visible currently sells, with the headline facts a purchase turns on — name, make, OS, list price, current price, financed monthly payment and term, in-stock status, pre-owned vs new, 5G support, eSIM compatibility, trade-in / Payback eligibility, and the catalogue image. Optional filters narrow by make (Apple, Samsung, Google, Motorola, TCL), by a `priceMax` the buyer's actually-going-to-pay price (NOT the strikethrough on a stale flash-sale banner), by 5G support, and by in-stock availability. Pagination is explicit and client-side over the catalogue's bounded 42-row response — the endpoint does NOT paginate server-side; every tried pagination parameter is ignored. Joins naturally with `getPhone`, which takes the same `slug` as its input — `searchPhones` answers \"what does Visible sell?\", `getPhone` answers \"what does this specific device cost across storage and colour?\".\n\nCalls `bowmark.providers.visible.searchPhones`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<VisibleSearchPhonesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"options":{"type":"object","properties":{"make":{"type":"string"},"priceMax":{"type":"number"},"supports5G":{"type":"boolean"},"inStock":{"type":"boolean"},"page":{"type":"number"},"pageSize":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ make?: string; priceMax?: number; supports5G?: boolean; inStock?: boolean; page?: number; pageSize?: number }`"}},"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/visible/checkCoverage":{"post":{"operationId":"checkCoverage","summary":"Returns Verizon's real network coverage — the tier that actually determines usable speed (5G Ultra Wideband, 5G Nationwide, or 4G LTE) — at a caller-supplied US street address or 5-digit ZIP, straight","description":"Returns Verizon's real network coverage — the tier that actually determines usable speed (5G Ultra Wideband, 5G Nationwide, or 4G LTE) — at a caller-supplied US street address or 5-digit ZIP, straight from the same point-level lookup Verizon's own coverage map (embedded in visible.com/plans/coverage) queries. Geocodes the input first — a full address via the US Census Bureau's public geocoder, a bare ZIP via a ZIP-centroid lookup — then reads the tiers at that exact point, never a national or per-ZIP summary standing in for an address-level answer. Also returns the site's own one-word verdict (\"Best\"/\"Good\"/\"Moderate\"/\"No Coverage\") as `summary`, measured to sometimes DISAGREE with the tier flags — the flags are the ones to trust.\n\nCalls `bowmark.providers.visible.checkCoverage`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<VisibleCheckCoverageResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"addressOrZip":{"type":"string","description":"TypeScript: `string`"}},"required":["addressOrZip"],"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/visible/getPlans":{"post":{"operationId":"getPlans","summary":"Returns the three tiers Visible sells today (Visible, Visible+, Visible+ Pro) as the plans page renders them — each tier's headline monthly price, the regular price the running promo unlocks (e.g.","description":"Returns the three tiers Visible sells today (Visible, Visible+, Visible+ Pro) as the plans page renders them — each tier's headline monthly price, the regular price the running promo unlocks (e.g. $19/mo with code SAVE6 unlocking $25/mo), the promo code itself, the \"Taxes & fees included\" guarantee, the marketing badge (\"Most popular\" / \"Best value\" / \"Ultimate experience\"), the CTA button code that pre-fills /shop/plan-selected, and four labelled feature sections (Network, Mobile Hotspot, International, The Extras) with every bullet the page shows. Reads the LIVE page only, never the site's own /docs/visible_plans.md, which is dated 2025-11-12 and answers the same prompt with two stale tiers and no code. Three tiers is hard — a future fourth tier changes the answer visibly rather than reading as a half-broken response.\n\nCalls `bowmark.providers.visible.getPlans`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<VisibleGetPlansResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"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}}}}}}