{"openapi":"3.1.0","info":{"title":"TurboTax API (Bowmark)","version":"e833508f87ff","description":"List TurboTax editions, compare pricing, search help articles, and find local tax experts.\n\nEvery function Bowmark has for TurboTax (turbotax.intuit.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/turbotax/listEditions":{"post":{"operationId":"listEditions","summary":"Every TurboTax online edition with its current federal and per-state price in US dollars: DIY (Free Edition, Deluxe, Premium), Live Assisted (Basic, Deluxe, Premium, Business) and Full Service, read f","description":"Every TurboTax online edition with its current federal and per-state price in US dollars: DIY (Free Edition, Deluxe, Premium), Live Assisted (Basic, Deluxe, Premium, Business) and Full Service, read from the editions page's own pricing data.\n\nCalls `bowmark.providers.turbotax.listEditions`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<TurboTaxEdition[]>`.","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/turbotax/listTaxTools":{"post":{"operationId":"listTaxTools","summary":"TurboTax's free tax calculators (TaxCaster refund estimator, tax bracket, W-4 withholding, self-employed, crypto and more) with a one-line description and link for each.","description":"TurboTax's free tax calculators (TaxCaster refund estimator, tax bracket, W-4 withholding, self-employed, crypto and more) with a one-line description and link for each.\n\nCalls `bowmark.providers.turbotax.listTaxTools`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<TurboTaxTool[]>`.","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/turbotax/searchArticles":{"post":{"operationId":"searchArticles","summary":"Searches the TurboTax help library (ttlc.intuit.com) and returns the official help articles — never the community Q&A threads the same index also carries — each with its title, url and a short snippet","description":"Searches the TurboTax help library (ttlc.intuit.com) and returns the official help articles — never the community Q&A threads the same index also carries — each with its title, url and a short snippet.\n\nCalls `bowmark.providers.turbotax.searchArticles`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<TurboTaxArticle[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"TypeScript: `string`"}},"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/turbotax/getArticle":{"post":{"operationId":"getArticle","summary":"Reads one TurboTax help article in full — pass a ttlc.intuit.com help-article url, such as one searchArticles returned — and returns its title, last-updated stamp, the whole body as plain text (steps ","description":"Reads one TurboTax help article in full — pass a ttlc.intuit.com help-article url, such as one searchArticles returned — and returns its title, last-updated stamp, the whole body as plain text (steps one per line) and its \"More like this\" related articles.\n\nCalls `bowmark.providers.turbotax.getArticle`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<TurboTaxHelpArticle>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"TypeScript: `string`"}},"required":["url"],"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/turbotax/estimateRefund":{"post":{"operationId":"estimateRefund","summary":"Runs TurboTax's TaxCaster refund estimator on the caller's numbers — filing status, wages, federal withholding, dependents and any other income or deductions — and returns the estimated federal refund","description":"Runs TurboTax's TaxCaster refund estimator on the caller's numbers — filing status, wages, federal withholding, dependents and any other income or deductions — and returns the estimated federal refund (negative = amount owed), total tax, credits, taxable income, standard deduction, effective rate and tax bracket, computed by TaxCaster's own engine for tax year 2025 or 2026.\n\nCalls `bowmark.providers.turbotax.estimateRefund`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<TurboTaxRefundEstimate>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/EstimateRefundArgs","description":"TypeScript: `EstimateRefundArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/turbotax/estimateWithholding":{"post":{"operationId":"estimateWithholding","summary":"Runs TurboTax's W-4 withholding calculator: from filing status, wages, pay frequency, federal tax withheld per paycheck and so far this year, projects the year's withholding over the paychecks left, h","description":"Runs TurboTax's W-4 withholding calculator: from filing status, wages, pay frequency, federal tax withheld per paycheck and so far this year, projects the year's withholding over the paychecks left, has TaxCaster's engine compute the refund or amount owed, and says how many extra dollars per paycheck (W-4 line 4(c)) would break even.\n\nCalls `bowmark.providers.turbotax.estimateWithholding`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<TurboTaxWithholdingEstimate>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/EstimateWithholdingArgs","description":"TypeScript: `EstimateWithholdingArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/turbotax/estimateSelfEmploymentTax":{"post":{"operationId":"estimateSelfEmploymentTax","summary":"Estimates a freelancer's federal tax on 1099 income with TaxCaster's own engine: pass selfEmploymentIncome (net profit) plus the same filing status, wages and other fields estimateRefund takes, and ge","description":"Estimates a freelancer's federal tax on 1099 income with TaxCaster's own engine: pass selfEmploymentIncome (net profit) plus the same filing status, wages and other fields estimateRefund takes, and get the total tax split into Schedule SE self-employment tax and income tax, the amount owed, and the quarterly estimated payment.\n\nCalls `bowmark.providers.turbotax.estimateSelfEmploymentTax`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<TurboTaxSelfEmploymentEstimate>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/EstimateRefundArgs","description":"TypeScript: `EstimateRefundArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/turbotax/compareEditions":{"post":{"operationId":"compareEditions","summary":"Compares the three TurboTax tiers (DIY, Live Assisted, Full Service) side by side: each tier's title, selling-point features and real federal price range, drawn from the compare page's own cards joine","description":"Compares the three TurboTax tiers (DIY, Live Assisted, Full Service) side by side: each tier's title, selling-point features and real federal price range, drawn from the compare page's own cards joined with the editions page's prices.\n\nCalls `bowmark.providers.turbotax.compareEditions`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<TurboTaxComparison[]>`.","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/turbotax/findLocalExperts":{"post":{"operationId":"findLocalExperts","summary":"Finds TurboTax Full Service offices near a US ZIP code, with each office's address, phone, hours and distance in miles from that ZIP — the physical office-locator population behind /local-tax-offices/","description":"Finds TurboTax Full Service offices near a US ZIP code, with each office's address, phone, hours and distance in miles from that ZIP — the physical office-locator population behind /local-tax-offices/, not the ~3,565 individual /local-tax-experts/ profile pages, which have no search surface of their own. Widens the search radius automatically (50mi, then 100, 250, 500) until an office answers, so a rural ZIP is not left with an empty list.\n\nCalls `bowmark.providers.turbotax.findLocalExperts`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<TurboTaxOffice[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"zip":{"type":"string","description":"TypeScript: `string`"}},"required":["zip"],"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/turbotax/getLocalExpert":{"post":{"operationId":"getLocalExpert","summary":"Reads one TurboTax local tax expert's profile page — pass a turbotax.intuit.com/local-tax-experts/<name>/<id>/ url, such as one from the site's own /local-tax-experts/ listing — and returns their job ","description":"Reads one TurboTax local tax expert's profile page — pass a turbotax.intuit.com/local-tax-experts/<name>/<id>/ url, such as one from the site's own /local-tax-experts/ listing — and returns their job title, bio, specialties, star rating, review count and office address.\n\nCalls `bowmark.providers.turbotax.getLocalExpert`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<TurboTaxExpert>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"TypeScript: `string`"}},"required":["url"],"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/turbotax/getLocalOffice":{"post":{"operationId":"getLocalOffice","summary":"Reads one TurboTax local tax office page — pass a turbotax.intuit.com/local-tax-offices/<state>/<city>/<id>/ url, such as findLocalExperts returned — and returns its address, the tax topics it offers,","description":"Reads one TurboTax local tax office page — pass a turbotax.intuit.com/local-tax-offices/<state>/<city>/<id>/ url, such as findLocalExperts returned — and returns its address, the tax topics it offers, and the tax experts working there, each with the /local-tax-experts/ profile url getLocalExpert takes.\n\nCalls `bowmark.providers.turbotax.getLocalOffice`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<TurboTaxOfficeDetail>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"TypeScript: `string`"}},"required":["url"],"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}}},"EstimateRefundArgs":{"type":"object","properties":{"filingStatus":{"anyOf":[{"const":"single"},{"const":"married-joint"},{"const":"married-separate"},{"const":"head-of-household"},{"const":"qualifying-surviving-spouse"}]},"taxYear":{"type":"number"},"wages":{"type":"number"},"federalWithholding":{"type":"number"},"age":{"type":"number"},"spouseWages":{"type":"number"},"spouseFederalWithholding":{"type":"number"},"spouseAge":{"type":"number"},"spouseSelfEmploymentIncome":{"type":"number"},"selfEmploymentIncome":{"type":"number"},"dependentsUnder17":{"type":"number"},"dependentsUnder13":{"type":"number"},"studentsAged17To23":{"type":"number"},"otherDependents":{"type":"number"},"claimedAsDependent":{"type":"boolean"},"unemploymentIncome":{"type":"number"},"socialSecurityIncome":{"type":"number"},"taxableInterest":{"type":"number"},"ordinaryDividends":{"type":"number"},"qualifiedDividends":{"type":"number"},"longTermCapitalGains":{"type":"number"},"shortTermCapitalGains":{"type":"number"},"iraDistribution":{"type":"number"},"iraContribution":{"type":"number"},"otherIncome":{"type":"number"},"tipIncome":{"type":"number"},"overtimePay":{"type":"number"},"studentLoanInterest":{"type":"number"},"mortgageInterest":{"type":"number"},"realEstateTax":{"type":"number"},"cashDonations":{"type":"number"},"medicalExpenses":{"type":"number"},"estimatedTaxPaid":{"type":"number"}},"required":["filingStatus"],"additionalProperties":true},"EstimateWithholdingArgs":{}}}}