{"uid":"cap_GosuZNXo3rASVVB_0rtMs","slug":"country-and-currency-codes-name-normalise-1f2b3542","name":"Country and Currency Codes – Name Normalise","description":"Normalise country names like USA, U.S. or United States of America to ISO codes; up to 25 per call, with confidence.","url":"https://country-codes-iso.x402tookit.com/name-normalise?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":["names"],"properties":{"names":{"type":"string","description":"Names separated by | or new lines, e.g. USA|U.S.|Deutschland"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"]},"results":{"type":["array","null"],"items":{"type":"object","properties":{"name":{"type":["null","string"]},"input":{"type":["null","string"]},"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"status":{"type":["null","string"]},"matchedOn":{"type":["null","string"]},"confidence":{"type":["null","number"]}}}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"disclaimer":{"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_z2FGGcjjYDpdThPnL54Z5","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":"Normalises free-text country name variants (e.g. USA, U.S., United States of America) to ISO 3166-1 alpha-2 and alpha-3 codes, with a confidence score, up to 25 names per call.","exampleAgentPrompt":"Can you normalise these country name variants to their ISO 3166-1 alpha-2 and alpha-3 codes with confidence scores: USA|U.S.|Deutschland|United States of America|UK?","exampleUseCases":[{"title":"Standardise messy country data in CRM","prompt":"I've got a list of country name variations from our CRM — things like 'USA', 'U.S.', 'United States of America', 'Deutschland', 'Great Britain' — can you convert them all to ISO 3166-1 alpha-2 and alpha-3 codes so our database is consistent?"},{"title":"E-commerce checkout country field cleanup","prompt":"Our checkout form accepts free-text country input and we're getting all sorts of variants like 'UK', 'England', 'Россия', 'Brasil' — can you resolve each one to its official ISO alpha-2 code and tell me the confidence level for each match?"},{"title":"Survey response normalisation","prompt":"I have survey responses where people typed their country in different ways — 'America', 'US', 'United States', 'Österreich', 'Korea' — can you normalise these to ISO 3166-1 codes and flag any low-confidence matches I should review?"}],"resultDescription":"Returns an array of result objects, one per input name, each containing the original input string, the matched canonical country name, ISO alpha-2 code, ISO alpha-3 code, match status, the field matched on, and a numeric confidence score. Also includes a summary, verdict, and optional degraded/disclaimer fields at the response level.","failureModes":["More than 25 names submitted in a single call — excess names may be skipped or rejected","Completely unrecognisable or misspelled strings return low confidence or null codes","Ambiguous names that map to multiple countries (e.g. 'Georgia') return the best-guess match with lower confidence","Missing 'names' query parameter causes a 400-level error","Service degraded flag set to true when operating in reduced-accuracy mode"],"whenToPreferThis":"Choose this endpoint when you need to resolve informal, user-typed, or multilingual country name variants to authoritative ISO 3166-1 codes at scale (up to 25 per call) and require a per-result confidence score to flag uncertain matches. It is purpose-built for name normalisation with fuzzy matching, unlike a plain code-conversion endpoint which only handles already-structured codes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:02:36.406Z","isFirstParty":false,"canonicalSlug":"country-and-currency-codes-name-normalise-1f2b3542"}