{"uid":"cap_qX1An7TDzxUec5BynjlYu","slug":"batch-us-sales-tax-rate-lookup-streamlined-sales-tax-e5285c2e","name":"Batch US Sales Tax Rate Lookup (Streamlined Sales Tax)","description":"Sales-tax rates for up to 100 US locations in one call (Streamlined Sales Tax states)","url":"https://data.spencermcw.com/v1/tax/sales-rate/batch?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"locations":{"type":"array","items":{"type":"object","required":["zip"],"properties":{"zip":{"type":"string","pattern":"^\\d{5}(-?\\d{4})?$","description":"A 5-digit ZIP code or a ZIP+4 (98101-3143 or 981013143)."},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"The sale date, YYYY-MM-DD (default: today, UTC). From the first day of the previous quarter onward."},"address":{"type":"string","maxLength":120,"minLength":3,"description":"Optional street address line with house number, e.g. \"1010 E Alder St\" or \"PO Box 12\"; matched against the state address records when it publishes them."}},"additionalProperties":false},"maxItems":100,"minItems":1}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3gLBnTOI8Kj_mHhRGhu1s","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns sales-tax rates for up to 100 US ZIP/address locations in a single API call, covering Streamlined Sales Tax states","exampleAgentPrompt":"Look up the sales tax rates for these 5 ZIP codes — 98101, 60601, 30301, 85001, and 10001 — for sales made today, so I can calculate the correct tax for each customer order.","exampleUseCases":[{"title":"E-commerce order tax calculation","prompt":"I have a batch of 40 customer shipping ZIP codes from today's orders — can you fetch the current sales tax rate for each one so I can finalize the invoices?"},{"title":"Multi-state payroll tax audit","prompt":"I need to verify the sales tax rates for 25 different ZIP codes across our Streamlined Sales Tax state locations as of last quarter — can you pull those rates for me?"},{"title":"Retail expansion tax planning","prompt":"We're considering opening stores in these 15 ZIP codes: 98101, 85004, 80203, 30303, 55101, 60601, 46201, 37201, 43201, 45202, 53201, 68501, 73101, 84101, 83701. Can you get the current sales tax rates for all of them?"}],"resultDescription":"An array of tax rate results corresponding to each submitted location, including the applicable sales tax rate (combined state/local rate) for that ZIP code or address in a Streamlined Sales Tax state, optionally as of a specified sale date.","failureModes":["Invalid ZIP code format returns a validation error for that location","Sale date outside of allowed range (before previous quarter start) returns an error","Non-SST state ZIP codes may return no results or an unsupported-state error","Submitting more than 100 locations returns a 400 bad request","Missing required 'zip' field for any location item causes a validation failure","Payment failure via x402 protocol results in a 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need sales tax rates for multiple US locations in a single round-trip — ideal for e-commerce checkout pipelines, batch invoice generation, or compliance audits covering up to 100 addresses at once. It is specifically optimized for Streamlined Sales Tax states. For a single location lookup, prefer the sibling single-address endpoint. For monitoring tax rate changes over time, use the quarterly changes feed endpoint.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T12:38:07.896Z","isFirstParty":false,"canonicalSlug":"batch-us-sales-tax-rate-lookup-streamlined-sales-tax-e5285c2e"}