{"openapi": "3.1.0", "info": {"title": "TaxMeUp API", "version": "1.0.0", "description": "TaxMeUp runs a 2025 federal ordinary-income scenario from published IRS brackets and standard deductions. It is an illustration, not a refund estimate, and it does not file returns.", "contact": {"url": "https://taxmeup.xyz/agents"}}, "servers": [{"url": "https://taxmeup.xyz"}], "paths": {"/v1/tax-scenario": {"post": {"operationId": "taxmeup_tax_scenario", "summary": "Model federal tax with and without deductions", "description": "Send filing_status, annual_income and optional amounts for office, advertising, charity and mortgage. Returns modeled tax before and after, with the form line for each item.", "tags": ["actions"], "x-scope": "write", "x-free": true, "security": [{}, {"bearerKey": []}], "responses": {"200": {"description": "Success", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "Bad input", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "401": {"description": "Missing, unknown or revoked key", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "403": {"description": "Key lacks the required scope", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "429": {"description": "Rate limit hit; see Retry-After", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}, "headers": {"Retry-After": {"schema": {"type": "integer"}}, "X-RateLimit-Limit": {"schema": {"type": "integer"}}, "X-RateLimit-Remaining": {"schema": {"type": "integer"}}}}}, "x-pricing": {"unit": "call", "price_usd": 0, "free_quota": "200 per day per IP", "note": "Keyed volume pricing is published at https://taxmeup.xyz/pricing"}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["annual_income"], "properties": {"filing_status": {"type": "string", "enum": ["Single", "Married Filing Jointly", "Married Filing Separately", "Head of Household", "Qualifying Widow(er)"]}, "annual_income": {"type": "number", "minimum": 0, "maximum": 10000000}, "amounts": {"type": "object", "additionalProperties": {"type": "number"}}}}}}}}}, "/v1/about": {"get": {"operationId": "taxmeup_about", "summary": "What TaxMeUp does and what is free", "description": "What TaxMeUp does and what is free", "tags": ["actions"], "x-scope": "read", "x-free": true, "security": [{}, {"bearerKey": []}], "responses": {"200": {"description": "Success", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "Bad input", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "401": {"description": "Missing, unknown or revoked key", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "403": {"description": "Key lacks the required scope", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "429": {"description": "Rate limit hit; see Retry-After", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}, "headers": {"Retry-After": {"schema": {"type": "integer"}}, "X-RateLimit-Limit": {"schema": {"type": "integer"}}, "X-RateLimit-Remaining": {"schema": {"type": "integer"}}}}}, "x-pricing": {"unit": "call", "price_usd": 0, "free_quota": "200 per day per IP", "note": "Keyed volume pricing is published at https://taxmeup.xyz/pricing"}}}, "/v1/pricing": {"get": {"operationId": "taxmeup_pricing", "summary": "Where prices live and what costs nothing", "description": "Where prices live and what costs nothing", "tags": ["actions"], "x-scope": "read", "x-free": true, "security": [{}, {"bearerKey": []}], "responses": {"200": {"description": "Success", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "Bad input", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "401": {"description": "Missing, unknown or revoked key", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "403": {"description": "Key lacks the required scope", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "429": {"description": "Rate limit hit; see Retry-After", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}, "headers": {"Retry-After": {"schema": {"type": "integer"}}, "X-RateLimit-Limit": {"schema": {"type": "integer"}}, "X-RateLimit-Remaining": {"schema": {"type": "integer"}}}}}, "x-pricing": {"unit": "call", "price_usd": 0, "free_quota": "200 per day per IP", "note": "Keyed volume pricing is published at https://taxmeup.xyz/pricing"}}}, "/v1/company": {"get": {"operationId": "taxmeup_get_company_info", "summary": "What TaxMeUp is, who runs it and where to read the terms", "description": "Returns the company name, what the product does, what it does not do, and the legal and contact URLs.", "tags": ["actions"], "x-scope": "read", "x-free": true, "security": [{}, {"bearerKey": []}], "responses": {"200": {"description": "Success", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "Bad input", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "401": {"description": "Missing, unknown or revoked key", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "403": {"description": "Key lacks the required scope", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "429": {"description": "Rate limit hit; see Retry-After", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}, "headers": {"Retry-After": {"schema": {"type": "integer"}}, "X-RateLimit-Limit": {"schema": {"type": "integer"}}, "X-RateLimit-Remaining": {"schema": {"type": "integer"}}}}}, "x-pricing": {"unit": "call", "price_usd": 0, "free_quota": "200 per day per IP", "note": "Keyed volume pricing is published at https://taxmeup.xyz/pricing"}}}, "/v1/price-list": {"get": {"operationId": "taxmeup_list_pricing", "summary": "The live price list: free analysis, $19 and $39 one-time reports, $199 concierge waitlist", "description": "Returns every offer and price shown on https://taxmeup.xyz/pricing, read from the same manifest as the page.", "tags": ["actions"], "x-scope": "read", "x-free": true, "security": [{}, {"bearerKey": []}], "responses": {"200": {"description": "Success", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "Bad input", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "401": {"description": "Missing, unknown or revoked key", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "403": {"description": "Key lacks the required scope", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "429": {"description": "Rate limit hit; see Retry-After", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}, "headers": {"Retry-After": {"schema": {"type": "integer"}}, "X-RateLimit-Limit": {"schema": {"type": "integer"}}, "X-RateLimit-Remaining": {"schema": {"type": "integer"}}}}}, "x-pricing": {"unit": "call", "price_usd": 0, "free_quota": "200 per day per IP", "note": "Keyed volume pricing is published at https://taxmeup.xyz/pricing"}}}, "/v1/buy-link": {"get": {"operationId": "taxmeup_get_checkout_link", "summary": "Get the buy link for a one-time TaxMeUp report", "description": "Returns the buy URL for the report ($19) or itemized ($39) report. The link opens a live Stripe Checkout page; nothing is charged until the buyer pays there. The concierge review is waitlist-only, so for it the pricing page URL is returned.", "tags": ["actions"], "x-scope": "read", "x-free": true, "security": [{}, {"bearerKey": []}], "responses": {"200": {"description": "Success", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "Bad input", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "401": {"description": "Missing, unknown or revoked key", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "403": {"description": "Key lacks the required scope", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "429": {"description": "Rate limit hit; see Retry-After", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}, "headers": {"Retry-After": {"schema": {"type": "integer"}}, "X-RateLimit-Limit": {"schema": {"type": "integer"}}, "X-RateLimit-Remaining": {"schema": {"type": "integer"}}}}}, "x-pricing": {"unit": "call", "price_usd": 0, "free_quota": "200 per day per IP", "note": "Keyed volume pricing is published at https://taxmeup.xyz/pricing"}, "parameters": [{"name": "tier", "in": "query", "required": true, "schema": {"type": "string", "enum": ["report", "itemized", "concierge"]}}]}}, "/v1/search": {"get": {"operationId": "taxmeup_search_site", "summary": "Search TaxMeUp pages by keyword", "description": "Returns up to five matching public pages with title, URL and a one-line summary.", "tags": ["actions"], "x-scope": "read", "x-free": true, "security": [{}, {"bearerKey": []}], "responses": {"200": {"description": "Success", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "Bad input", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "401": {"description": "Missing, unknown or revoked key", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "403": {"description": "Key lacks the required scope", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "429": {"description": "Rate limit hit; see Retry-After", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}, "headers": {"Retry-After": {"schema": {"type": "integer"}}, "X-RateLimit-Limit": {"schema": {"type": "integer"}}, "X-RateLimit-Remaining": {"schema": {"type": "integer"}}}}}, "x-pricing": {"unit": "call", "price_usd": 0, "free_quota": "200 per day per IP", "note": "Keyed volume pricing is published at https://taxmeup.xyz/pricing"}, "parameters": [{"name": "query", "in": "query", "required": true, "schema": {"type": "string", "minLength": 2, "maxLength": 100}}]}}, "/v1/usage": {"get": {"operationId": "usage_get", "summary": "Usage for the calling key (last 30 days)", "tags": ["account"], "x-scope": "read", "security": [{"bearerKey": []}], "responses": {"200": {"description": "Usage counters", "content": {"application/json": {"schema": {"type": "object", "properties": {"key_id": {"type": "string"}, "calls": {"type": "integer"}, "by_operation": {"type": "object", "additionalProperties": {"type": "integer"}}}}}}}, "401": {"description": "Missing, unknown or revoked key", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "403": {"description": "Key lacks the required scope", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "429": {"description": "Rate limit hit; see Retry-After", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}, "headers": {"Retry-After": {"schema": {"type": "integer"}}, "X-RateLimit-Limit": {"schema": {"type": "integer"}}, "X-RateLimit-Remaining": {"schema": {"type": "integer"}}}}}}}}, "components": {"securitySchemes": {"bearerKey": {"type": "http", "scheme": "bearer", "description": "API key. Free-tier operations also work without a key (rate limited)."}}, "schemas": {"Error": {"type": "object", "required": ["error"], "properties": {"error": {"type": "object", "required": ["code", "message"], "properties": {"code": {"type": "string"}, "message": {"type": "string"}}}}}}}, "x-rate-limits": {"free": {"requests_per_minute": 10, "requests_per_day": 200}, "keyed": {"requests_per_minute": 120}}, "x-pricing": {"currency": "USD", "summary": "The tax scenario is free without a key, up to 200 calls a day per IP. Keyed volume pricing is published at https://taxmeup.xyz/pricing.", "default": {"unit": "call", "price_usd": 0, "free_quota": "200 per day per IP", "note": "Keyed volume pricing is published at https://taxmeup.xyz/pricing"}}}