{"openapi":"3.1.0","info":{"title":"AT&T API (Bowmark)","version":"e833508f87ff","description":"att.com's own phone catalog and device pricing — a phone's current full retail price and AT&T Installment Plan financing (term, monthly payment, Next Up Anytime charge, trade-in and port-in promotions), read off AT&T's own product pages.\n\nEvery function Bowmark has for AT&T (att.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/att/findDevices":{"post":{"operationId":"findDevices","summary":"Every phone on AT&T's own phones listing (att.com/buy/phones/) — name, brand, product page URL and headline price.","description":"Every phone on AT&T's own phones listing (att.com/buy/phones/) — name, brand, product page URL and headline price. A query narrows it by words (\"iphone 16 pro\", \"galaxy s25\"), shortest name first; no query returns the whole listing. The door: a caller who knows only what the phone is called gets the URL getDevicePricing takes.\n\nCalls `bowmark.providers.att.findDevices`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AttDevice[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"TypeScript: `string`"}},"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/att/listTablets":{"post":{"operationId":"listTablets","summary":"Every tablet on AT&T's own tablets listing (att.com/buy/tablets/): iPads, Galaxy Tabs, TCL and AT&T amiGO tablets, each with name, brand, product page URL and listedPriceUsd, which is the MONTHLY inst","description":"Every tablet on AT&T's own tablets listing (att.com/buy/tablets/): iPads, Galaxy Tabs, TCL and AT&T amiGO tablets, each with name, brand, product page URL and listedPriceUsd, which is the MONTHLY installment AT&T shows on the tile (not the outright price). A query narrows by words (\"ipad pro\", \"galaxy tab\"), shortest name first. An empty array with a query means no tablet matched; the page itself listing none throws.\n\nCalls `bowmark.providers.att.listTablets`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AttDevice[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"TypeScript: `string`"}},"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/att/getDevicePricing":{"post":{"operationId":"getDevicePricing","summary":"AT&T's current price and financing for a phone, per storage/colour variant: full retail price, the AT&T Installment Plan (term in months, monthly payment, total), the optional Next Up Anytime monthly ","description":"AT&T's current price and financing for a phone, per storage/colour variant: full retail price, the AT&T Installment Plan (term in months, monthly payment, total), the optional Next Up Anytime monthly charge, the port-in discount and any trade-in promotions. `device` is a NAME (\"iPhone 16 Pro\", matched against AT&T's phones listing) or an att.com/buy/phones/... page URL. AT&T's page prices only some variants up front; the rest come back with `priced: false`. THROWS if no phone on the listing matches the name.\n\nCalls `bowmark.providers.att.getDevicePricing`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AttDevicePricing>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"device":{"type":"string","description":"TypeScript: `string`"}},"required":["device"],"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/att/listPlans":{"post":{"operationId":"listPlans","summary":"Every unlimited wireless plan on AT&T's own plan-picker page (att.com/plans/unlimited-data-plans/): name, headline data feature in AT&T's own words, the per-line monthly price at each line count AT&T ","description":"Every unlimited wireless plan on AT&T's own plan-picker page (att.com/plans/unlimited-data-plans/): name, headline data feature in AT&T's own words, the per-line monthly price at each line count AT&T breaks pricing by (the family/multi-line discount ladder), and whether an international calling/data feature is included. Covers the postpaid unlimited lineup this page sells; AT&T Prepaid runs on a separate site section not covered here.\n\nCalls `bowmark.providers.att.listPlans`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AttPlan[]>`.","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"}}}}}}},"/v1/sites/att/listPrepaidPlans":{"post":{"operationId":"listPrepaidPlans","summary":"Every AT&T Prepaid plan on AT&T's own prepaid plans page (att.com/prepaid/plans/): name, monthly price (with any prepay condition, e.g.","description":"Every AT&T Prepaid plan on AT&T's own prepaid plans page (att.com/prepaid/plans/): name, monthly price (with any prepay condition, e.g. the 12-month plan's \"When you prepay $240\"), every price the card shows, and the card's feature list in AT&T's own words (hotspot data, 5G, international texting, price lock). The prepaid lineup only; listPlans covers postpaid unlimited.\n\nCalls `bowmark.providers.att.listPrepaidPlans`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AttPrepaidPlan[]>`.","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"}}}}}}},"/v1/sites/att/listTvPlans":{"post":{"operationId":"listTvPlans","summary":"Every AT&T TV package on AT&T's own TV page (att.com/tv/): streaming (ENTERTAINMENT, CHOICE, ULTIMATE, PREMIER), satellite and Spanish-language packages, plus the genre packs (MyKids, MySports...), ea","description":"Every AT&T TV package on AT&T's own TV page (att.com/tv/): streaming (ENTERTAINMENT, CHOICE, ULTIMATE, PREMIER), satellite and Spanish-language packages, plus the genre packs (MyKids, MySports...), each with channel count and shop URL. Genre packs carry their monthly price; base packages are priced live per address, so monthlyUsd is null and regularMonthlyUsd is set only where the page's fine print names it (ENTERTAINMENT).\n\nCalls `bowmark.providers.att.listTvPlans`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AttTvPlan[]>`.","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"}}}}}}},"/v1/sites/att/listInternetPlans":{"post":{"operationId":"listInternetPlans","summary":"Every AT&T Fiber home-internet speed tier on AT&T's own fiber page (att.com/internet/fiber/): tier name (\"AT&T Internet 1000\"), speed in AT&T's words and in Mbps, the monthly offer price on its own, t","description":"Every AT&T Fiber home-internet speed tier on AT&T's own fiber page (att.com/internet/fiber/): tier name (\"AT&T Internet 1000\"), speed in AT&T's words and in Mbps, the monthly offer price on its own, the regular (struck-through) price, the lower price when bundled with an AT&T wireless plan, perks (reward card, YouTube TV months) and the feature list. National list prices; whether a tier reaches a given address is a separate question.\n\nCalls `bowmark.providers.att.listInternetPlans`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AttInternetPlan[]>`.","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"}}}}}}},"/v1/sites/att/findStores":{"post":{"operationId":"findStores","summary":"AT&T stores near a US ZIP or \"city, state\", nearest first, off AT&T's own store locator: name, address, phone, store page URL, distance in miles, whether AT&T owns the store (false = an authorized ret","description":"AT&T stores near a US ZIP or \"city, state\", nearest first, off AT&T's own store locator: name, address, phone, store page URL, distance in miles, whether AT&T owns the store (false = an authorized retailer) and opening hours per weekday (\"09:00-20:00\"). limit defaults to 10 (max 50), radiusMiles to 25 (max 100). An empty array means no store within the radius.\n\nCalls `bowmark.providers.att.findStores`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AttStore[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"limit":{"type":"number"},"radiusMiles":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ limit?: number; radiusMiles?: number }`"}},"required":["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/att/listDeals":{"post":{"operationId":"listDeals","summary":"The current offers on AT&T's own deals page (att.com/deals/): each card's headline in AT&T's words (\"Get iPhone 18 Pro Max for up to $1,200 off\"), who it is for (\"New & existing customers\"), the short","description":"The current offers on AT&T's own deals page (att.com/deals/): each card's headline in AT&T's words (\"Get iPhone 18 Pro Max for up to $1,200 off\"), who it is for (\"New & existing customers\"), the short condition line, the shop URL, and which row of the page it sits in (featured, top, bundles, accessories). The fine print stays on AT&T's page behind each URL.\n\nCalls `bowmark.providers.att.listDeals`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AttDeal[]>`.","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"}}}}}}},"/v1/sites/att/getTradeInValue":{"post":{"operationId":"getTradeInValue","summary":"What an old phone is worth toward AT&T, off AT&T's own trade-in tool (tradein.att.com): every matching model (\"iPhone 14 128GB\", \"Galaxy S23\") with its trade-in value in USD before the condition quest","description":"What an old phone is worth toward AT&T, off AT&T's own trade-in tool (tradein.att.com): every matching model (\"iPhone 14 128GB\", \"Galaxy S23\") with its trade-in value in USD before the condition questions (a cracked or locked phone is worth less, and AT&T asks those on its site). valueUsd 0 / recycleOnly true means AT&T only recycles it. limit defaults to 10 (max 50); an empty array means AT&T lists no model by that name.\n\nCalls `bowmark.providers.att.getTradeInValue`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AttTradeInValue[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"device":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ limit?: number }`"}},"required":["device"],"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/att/getTradeInQuote":{"post":{"operationId":"getTradeInQuote","summary":"What AT&T pays for THIS phone in ITS condition, off AT&T's own trade-in tool (tradein.att.com): the best match for device (\"iPhone 14 128GB\"), AT&T's condition questions answered from condition (each ","description":"What AT&T pays for THIS phone in ITS condition, off AT&T's own trade-in tool (tradein.att.com): the best match for device (\"iPhone 14 128GB\"), AT&T's condition questions answered from condition (each defaults to true, the good answer), and the resulting price in USD beside the before-condition value (iPhone 14 128GB: 180 good, 90 with screenIntact false). Also the trade-in promotions AT&T offers on a new phone, biggest bill credit first. Throws when AT&T lists no model by that name; use getTradeInValue to see the candidates.\n\nCalls `bowmark.providers.att.getTradeInQuote`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AttTradeInQuote>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"device":{"type":"string","description":"TypeScript: `string`"},"condition":{"type":"object","properties":{"powersOn":{"type":"boolean"},"activationLockOff":{"type":"boolean"},"screenIntact":{"type":"boolean"}},"additionalProperties":true,"description":"TypeScript: `{ powersOn?: boolean; activationLockOff?: boolean; screenIntact?: boolean }`"}},"required":["device"],"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/att/getAccountBalance":{"post":{"operationId":"getAccountBalance","summary":"The signed-in caller's current AT&T account balance — amount due, due date and account status — off myatt.com's account overview.","description":"The signed-in caller's current AT&T account balance — amount due, due date and account status — off myatt.com's account overview. CALLER-login function, declared in authFunctions: pauses the run for a sign-in when the caller holds none, and throws when a saved sign-in has gone dead (the site bounces to signin.att.com).\n\nCalls `bowmark.providers.att.getAccountBalance`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AttAccountBalance>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/att/getUsage":{"post":{"operationId":"getUsage","summary":"Data, talk and text usage for a line on the signed-in caller's account: data used/limit (GB), talk minutes used, texts sent.","description":"Data, talk and text usage for a line on the signed-in caller's account: data used/limit (GB), talk minutes used, texts sent. Omitting lineId reads the primary line's usage; pass the lineId returned by listLines for another line. CALLER-login function, declared in authFunctions.\n\nCalls `bowmark.providers.att.getUsage`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AttLineUsage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lineId":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/att/listLines":{"post":{"operationId":"listLines","summary":"Every line on the signed-in caller's AT&T account: phone number, device, plan name, upgrade eligibility, and a lineId to pass to getUsage.","description":"Every line on the signed-in caller's AT&T account: phone number, device, plan name, upgrade eligibility, and a lineId to pass to getUsage. CALLER-login function, declared in authFunctions.\n\nCalls `bowmark.providers.att.listLines`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AttLine[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/att/viewBillHistory":{"post":{"operationId":"viewBillHistory","summary":"The signed-in caller's past bills: month, amount due and payment date.","description":"The signed-in caller's past bills: month, amount due and payment date. Limit defaults to 12; pass a smaller number for only the most recent N. CALLER-login function, declared in authFunctions.\n\nCalls `bowmark.providers.att.viewBillHistory`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AttBillHistoryEntry[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"number","description":"TypeScript: `number`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/att/viewOrderHistory":{"post":{"operationId":"viewOrderHistory","summary":"The signed-in caller's past device and accessory orders from AT&T: order date, tracking number, delivery status and order total.","description":"The signed-in caller's past device and accessory orders from AT&T: order date, tracking number, delivery status and order total. Limit defaults to 20. CALLER-login function, declared in authFunctions.\n\nCalls `bowmark.providers.att.viewOrderHistory`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AttOrder[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"number","description":"TypeScript: `number`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/att/getMonthlyBill":{"post":{"operationId":"getMonthlyBill","summary":"One month's AT&T bill: total due, due date and auto-pay status, off myatt.com's bill page.","description":"One month's AT&T bill: total due, due date and auto-pay status, off myatt.com's bill page. `month` is YYYY-MM (\"2026-09\"); omitted means the current/most recent bill. CALLER-login function, declared in authFunctions.\n\nCalls `bowmark.providers.att.getMonthlyBill`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AttMonthlyBill>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"month":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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}}}}}}