{"uid":"cap_zKWDWxVKtCLRRt0GEwCFa","slug":"usaref-working-days-government-reference-data-series-00426c0b","name":"usaref Working Days / Government Reference Data Series","description":"Working days in a date range: weekends + public holidays applied, next working day","url":"https://usaref.dev/v1/answers/working-days?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["country","from","to"],"properties":{"to":{"type":"string","format":"date","description":"Range end, inclusive (max 366 days)"},"from":{"type":"string","format":"date","description":"Range start, inclusive"},"country":{"enum":["bs","ca","cr","do","gt","hn","mx","pa","sv","us"],"type":"string","description":"ISO country code"},"receipt":{"type":"boolean","description":"Optional. true adds an Ed25519 answer receipt on a paid 200, incluedd in this price. Not a certified extract."},"subdivision":{"type":"string","description":"Optional. Apply a sub-national statutory holiday calendar (national + that region's days) instead of national-only. ISO 3166-2 code, e.g. 'DE-BY'. Countries that offer regions expose them as `subdivisions` on GET /:country/public-holidays. Unknown code is refused free with the list."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["status","total_days","working_days","next_working_day"],"properties":{"status":{"type":"string"},"caveats":{"type":"array"},"receipt":{"type":"object","description":"Only when receipt=true on a paid 200. kind answer_receipt. Verify at /certified/public-key."},"weekend":{"type":"array","description":"This country's weekly rest days (Egypt: Fri–Sat)"},"disclaimer":{"type":"string"},"provenance":{"type":"object","description":"The statutory instrument the answer rests on: effective_from, last_confirmed, official source URL, notes"},"total_days":{"type":"integer"},"subdivision":{"type":["object","null"],"description":"The sub-national calendar applied (code, name, source, the region's added days), or null when the national calendar was used"},"weekend_days":{"type":"integer"},"working_days":{"type":"integer"},"public_holidays":{"type":"array","description":"Statutory holidays falling on weekdays in the range"},"next_working_day":{"type":"string","format":"date"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_D7rFy0q8D06dHaNo6-Xxk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a specific North American government reference data series (e.g. public holidays, minimum wage, VAT, policy rate) for a given country","exampleAgentPrompt":"What is the current minimum wage in the US according to usaref? Also check whether the data is marked stale.","exampleUseCases":[{"title":"Look up VAT rate for Mexico","prompt":"Can you find the current VAT rate for Mexico using usaref? I need the official rate with source attribution so I can use it in a pricing calculation."},{"title":"Get Canada public holiday calendar","prompt":"Pull up the list of public holidays in Canada from usaref — I need to know which dates to block off when scheduling meetings with our Canadian team this year."},{"title":"Check Costa Rica central bank rate","prompt":"What is the current central bank policy interest rate in Costa Rica according to usaref? Also let me know when the data was last confirmed and whether it's marked as stale."}],"resultDescription":"A JSON object containing the series identifier, country code, current value (a number for rates/wages or an array of {date, name} objects for holiday calendars), effective_from date, last_confirmed date, source attribution, a stale boolean flag, optional unit and notes, and an optional components array breaking down composite rates.","failureModes":["Invalid or unsupported country code returns a 400 or 404 error","Invalid series name returns a 400 or 404 error","Payment not provided or insufficient triggers a 402 Payment Required response","Data marked stale (stale: true) means it is past its expected update cycle and may be outdated","Network or upstream timeout may result in a 500 error"],"whenToPreferThis":"Use this endpoint when you need authoritative, government-sourced reference values for North American and Central American countries — especially tax rates, minimum wages, central bank policy rates, CPI, or official public holiday calendars. Prefer this over generic web search when you need structured, machine-readable data with source attribution and freshness metadata.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T06:37:09.160Z","isFirstParty":false,"canonicalSlug":"usaref-working-days-government-reference-data-series-00426c0b"}