{"uid":"cap_I5-PCHzzFNE4qtHOXez17","slug":"data-spencermcw-com-sales-tax-rate-lookup-7ea3c2d6","name":"data.spencermcw.com Sales Tax Rate Lookup","description":"What is the sales tax rate at this US address, ZIP+4 or ZIP? The combined rate and each state, county, city and district rate in the 24 Streamlined Sales Tax states (WA, OH, MI, NJ, TN, …), computed by Distill from each state’s SST rate and boundary files. Updated quarterly. $0.005 per call (x402, USDC on Base); 3 free calls a day.","url":"https://data.spencermcw.com/v1/tax/sales-rate?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["zip"],"properties":{"zip":{"type":"string","pattern":"^\\d{5}(-?\\d{4})?$"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"address":{"type":"string","maxLength":120,"minLength":3}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"data":{"type":"object","required":["location","state","state_fips","matched","rate","combined","components","jurisdiction_codes","alternate","effective","agreement"],"properties":{"rate":{"type":"string"},"state":{"type":"string"},"matched":{"enum":["address","zip4","zip5"],"type":"string"},"combined":{"type":"object","required":["general","food_drug"],"properties":{"general":{"type":"object"},"food_drug":{"type":"object"}},"additionalProperties":false},"location":{"type":"object","required":["zip","plus4","address","date"],"properties":{"zip":{"type":"string"},"date":{"type":"string"},"plus4":{"type":["string","null"]},"address":{"type":["string","null"]}},"additionalProperties":false},"agreement":{"type":"object","required":["finer_records","agreeing"],"properties":{"agreeing":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"finer_records":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991}},"additionalProperties":false},"alternate":{"type":"array","items":{"type":"object","required":["product","code","rate"],"properties":{"code":{"type":"string"},"rate":{"type":"string"},"product":{"type":"string"}},"additionalProperties":false}},"effective":{"type":"object","required":["from","to"],"properties":{"to":{"type":["string","null"]},"from":{"type":"string"}},"additionalProperties":false},"components":{"type":"array","items":{"type":"object","required":["jurisdiction","code","type","type_name","general","food_drug","effective_from","effective_to"],"properties":{"code":{"type":"string"},"type":{"type":"string"},"general":{"type":"object"},"food_drug":{"type":"object"},"type_name":{"type":"string"},"effective_to":{"type":["string","null"]},"jurisdiction":{"enum":["state","county","place","special"],"type":"string"},"effective_from":{"type":"string"}},"additionalProperties":false}},"state_fips":{"type":"string"},"jurisdiction_codes":{"type":"object","required":["state_indicator","county","place","place_class","composite_ser_code","specials"],"properties":{"place":{"type":["string","null"]},"county":{"type":["string","null"]},"specials":{"type":"array"},"place_class":{"type":["string","null"]},"state_indicator":{"type":"string"},"composite_ser_code":{"type":["string","null"]}},"additionalProperties":false}},"additionalProperties":false}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uh_qw6ukoUVnkGd4Ik6Io","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the sales-tax rate for a US location (ZIP+4, ZIP, or street address) in Streamlined Sales Tax states","exampleAgentPrompt":"What's the current sales tax rate for ZIP code 98101-2345 in Seattle — I need the combined general rate and any separate food/drug rate for a Streamlined Sales Tax state?","exampleUseCases":[{"title":"E-commerce checkout tax calculation","prompt":"What's the sales tax rate I should apply to a customer order shipping to ZIP code 80202 in Colorado? I need the combined general rate including state and local."},{"title":"Food delivery app tax compliance","prompt":"Look up the sales tax rate for 60601 as of 2024-07-01 — specifically the food and drug rate — so I can apply the right tax to a grocery delivery in Chicago."},{"title":"Accounting software address-level tax verification","prompt":"Can you get the sales tax rate for the address 123 Main St in ZIP+4 98004-1234? I want to confirm whether it matches at the address level or just the ZIP."}],"resultDescription":"Returns a JSON object with the matched precision level (address, zip4, or zip5), the state and location details, the effective date range, combined general and food/drug rates, individual tax component breakdown, jurisdiction codes, and an agreement score indicating how many records agreed on the rate.","failureModes":["ZIP code not found or not in a Streamlined Sales Tax state — no rate returned","Invalid ZIP format — 400 validation error","Address provided but not matchable — falls back to zip4 or zip5 precision","Date out of range for available rate data — may return null effective 'to' date","Payment failure (x402) — call blocked if USDC payment not completed"],"whenToPreferThis":"Use this endpoint when you need precise, address-level or ZIP+4-level sales tax rates for US locations specifically in Streamlined Sales Tax member states. It is ideal for e-commerce checkout flows, tax compliance software, and invoice generation where accuracy matters at the sub-ZIP level. Prefer this over generic tax APIs when you need food/drug rate breakdowns, jurisdiction codes, and confidence signals (agreement score) on the matched rate.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T12:30:18.902Z","isFirstParty":false,"canonicalSlug":"data-spencermcw-com-sales-tax-rate-lookup-7ea3c2d6"}