{"uid":"cap_z8SmsTp12ySFMTkiI8VY-","slug":"usaref-certified-country-series-lookup-8f7abb42","name":"usaref Certified Country/Series Lookup","description":"North American government reference data for 10 countries as cited JSON: central-bank policy rates, VAT/GST and VAT registration thresholds, CPI, corporate, personal and withholding tax, social contributions, minimum wages, statutory interest, official FX rates, filing deadlines and public holidays (coverage varies by country). Every value carries its official source URL and last-confirmed date. Single facts $0.003; country brief (every series for one country) $0.01; cross-country compare (one series, up to 10 countries) $0.02; tax-ID and VAT-number checks $0.003; computed answers (VAT, income tax, working days, minimum-wage check) $0.01-$0.02. Pay per call in USDC on Base via x402 or MPP, no signup, or by card with credit packs or monthly plans on one key valid across all 7 regional services. Free tier: GET /catalog, plus a free email key with 50 answer calls a day, commercial use allowed. Finished answers, one cited dossier per call (supported countries vary per job; others are refused free): cost this hire (wage-floor verdict, contributions, employer cost) $0.50; charge this sale (which VAT applies, net/VAT/gross) $0.50; charge this sale certified (plus a signed VAT-rate extract) $0.75; invoice due date and statutory late interest $0.40; country evidence pack (brief plus signed extracts) $0.25; hire compare $0.75 for 2 countries, $1.00 for 3-5; next filings (VAT, PAYE, corporate-tax due dates rolled for holidays) $0.35.\n\nFree trial: 3 computed-answer calls per day per IP on POST /v1/answers/* with header X-Free-Trial: 1 (without it, the normal x402 402; once used up, the 402 carries free_trial_resets_at). MCP answer tools use the trial automatically when no api_key is passed. Every series of the evaluation country is free. Card credit (same per-call price as x402): /pricing.","url":"https://usaref.dev/v1/certified/%7Bcountry%7D/%7Bseries%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"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_530zzBYNfut-kCGcgC06j","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 a single certified, source-cited government reference value (e.g. policy rate, VAT rate, CPI, minimum wage) for a specified North American country and data series","exampleAgentPrompt":"What is the current VAT rate for Mexico — I need the official government-cited figure with its source URL and the date it was last confirmed?","exampleUseCases":[{"title":"Cross-border tax compliance check","prompt":"What is the current corporate tax rate in Canada? I need the official cited value with its source URL so I can verify our compliance filing."},{"title":"Minimum wage payroll audit","prompt":"Look up the official minimum wage for Guatemala right now — I need the government-cited rate and when it was last confirmed so I can audit our payroll."},{"title":"Central bank rate for FX model","prompt":"What is the Bank of Mexico's current policy interest rate? Give me the official cited figure with its source and last-confirmed date for our FX pricing model."}],"resultDescription":"A JSON object containing the official government reference value for the requested country and data series, including the numeric value with units, the official source URL from which it was drawn, and the last-confirmed date. The response is structured as a single cited dossier for the specified series/country pair.","failureModes":["Country not covered by the service — returns an error or refusal indicating unsupported country","Series not available for the requested country — endpoint refuses with an explanation of coverage limits","Invalid country or series path parameter — returns a 400 or 404 error","Payment not completed or insufficient credit — returns a 402 Payment Required response","Stale data flag present — value returned but marked as potentially outdated via a 'stale' field"],"whenToPreferThis":"Choose this endpoint when you need a single, officially cited government reference value for one specific country and one specific data series (e.g. VAT rate for Mexico, policy rate for Canada). It is the right choice when auditability and provenance matter — every value includes its official source URL and last-confirmed date. Prefer it over general web search or LLM recall when you need machine-readable, structured, and citable compliance-grade data for North American jurisdictions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T00:31:15.550Z","isFirstParty":false,"canonicalSlug":"usaref-certified-country-series-lookup-8f7abb42"}