{"uid":"cap_n2KqhAmaoIY7HZxjVclQM","slug":"country-and-currency-codes-code-validator-dea041d0","name":"Country and Currency Codes – Code Validator","description":"Validate an ISO 3166-1, 4217 or 639 code or a ccTLD or dial code: assigned, reserved, deleted or unknown.","url":"https://country-codes-iso.x402tookit.com/code-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":["code","kind"],"properties":{"code":{"type":"string","description":"The code to check, e.g. GB, EUR, 840, fr, .uk, +44"},"kind":{"type":"string","description":"One of: country-alpha2, country-alpha3, country-numeric, currency, currency-numeric, language-639-1, language-639-2, cctld, calling-code"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"code":{"type":["null","string"]},"kind":{"type":["null","string"]},"note":{"type":["null","string"]},"valid":{"type":["boolean","null"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"]},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"disclaimer":{"type":["null","string"]},"normalised":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","string"]}}}}}}},"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_mG5FSdc_U764vTP2tS1SO","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":"Validates an ISO 3166-1, 4217, or 639 code (or a ccTLD or dial code) and returns its status: assigned, reserved, deleted, or unknown.","exampleAgentPrompt":"Can you check whether 'EUR' is a valid ISO 4217 currency code and tell me if it's currently assigned?","exampleUseCases":[{"title":"Validate user-submitted country code","prompt":"A user just filled out a form with country code 'XK' — is that a valid ISO 3166-1 alpha-2 country code, or is it reserved or unofficial?"},{"title":"Check if a ccTLD is legitimate","prompt":"Is '.uk' a real, assigned country-code top-level domain? I need to know its status before using it in a domain registrar lookup."},{"title":"Verify language code before API call","prompt":"Before I pass it downstream, can you confirm that 'zxx' is a valid ISO 639-2 language code and tell me what status it has — assigned, reserved, or something else?"}],"resultDescription":"Returns a structured object with fields including: valid (boolean), verdict (e.g. 'assigned', 'reserved', 'deleted', 'unknown'), normalised code, summary description, note, source authority, reasons array explaining the outcome, asOf timestamp indicating data freshness, and optional disclaimer. Also indicates if the check was degraded or if some sub-checks were skipped.","failureModes":["Missing required query parameters 'code' or 'kind' returns an error","Invalid 'kind' enum value causes a validation error","Ambiguous or malformed codes may return verdict 'unknown' rather than an error","Service degradation may result in degraded:true with partial results","Network or payment failure returns no response"],"whenToPreferThis":"Use this endpoint when you need to definitively verify whether a specific code string conforms to a known ISO standard (3166-1, 4217, 639) or is a valid ccTLD or ITU calling code, especially when you already know the code type. Prefer it over fuzzy-lookup or conversion endpoints when you want a strict assigned/reserved/deleted/unknown verdict rather than a translation or enrichment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:04:58.550Z","isFirstParty":false,"canonicalSlug":"country-and-currency-codes-code-validator-dea041d0"}