{"uid":"cap_MvYQHfKYSxQOJGiF7BAJs","slug":"usaref-tax-id-vat-number-validator-north-america-1e258295","name":"Usaref Tax ID / VAT Number Validator (North America)","description":"Tax-ID / VAT-number validation for North American countries: valid/invalid, normalised form, id type and the reason it failed. Format plus the official check-digit algorithm where the tax authority publishes one; every rule cited to an official source with its date. Pure algorithmic, no registry lookup","url":"https://usaref.dev/v1/taxid/validate?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":["country","id"],"properties":{"id":{"type":"string","description":"The tax ID / VAT number as written (spaces, dots, dashes and the VAT country prefix are accepted)"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code on this brand (see GET /v1/taxid/coverage)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KQvXWY0eiZGwH8TFq3_Fj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates and normalises Tax IDs and VAT numbers for North American countries using official format rules and check-digit algorithms, returning validity, normalised form, ID type, and failure reason","exampleAgentPrompt":"Can you check whether '12-3456789' is a valid US EIN — I need to know if it passes the official format and check-digit rules, and what type of tax ID it is?","exampleUseCases":[{"title":"Pre-invoice vendor tax ID check","prompt":"Before I add this vendor to our system, can you validate their US EIN '98-7654321' and tell me if it's a real, correctly formatted tax ID?"},{"title":"Onboarding Canadian business number","prompt":"We're onboarding a Canadian supplier who gave us BN '123456789 RT0001' — can you check if that's a valid Canadian business number format?"},{"title":"Bulk payment form validation","prompt":"A customer just entered '845 123 456' as their Mexican RFC tax ID — does it pass the official format check, and what's the normalised form I should store?"}],"resultDescription":"Returns a JSON object containing: a boolean validity flag, the normalised form of the tax ID, the detected ID type (e.g. EIN, SSN, BN, RFC), and if invalid, a human-readable reason explaining which format rule or check-digit algorithm failed, with citations to official sources","failureModes":["Missing required 'country' or 'id' query parameter returns 400 error","Unsupported or non-North-American country code returns coverage error or 400","Malformed ID string that cannot be parsed returns invalid with reason","Country code not in /v1/taxid/coverage list returns unsupported country error","Network timeout or service unavailability returns 5xx"],"whenToPreferThis":"Choose this endpoint when you need a fast, pure-algorithmic Tax ID or VAT number validation for North American countries (US, Canada, Mexico, and others in the coverage list) that does not require a live registry lookup. It is ideal for pre-validation in onboarding flows, invoice processing, or compliance checks where you need the normalised ID form, type classification, and an official-source-cited reason for any failure. Prefer this over EU VAT validation services for North American tax IDs specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:34:38.451Z","isFirstParty":false,"canonicalSlug":"usaref-tax-id-vat-number-validator-north-america-1e258295"}