{"openapi":"3.1.0","info":{"title":"Country and Currency Codes","version":"1.0.0","description":"ISO 3166 countries, ISO 4217 currencies, ISO 639 languages, calling codes and TLDs as an offline reference. One call, one computed answer, no accounts or API keys. Machine-payable over x402.","x-guidance":"Country and Currency Codes: ISO 3166 countries, ISO 4217 currencies, ISO 639 languages, calling codes and TLDs as an offline reference. Use /code-lookup to find a country by any code or name, /code-validate to check a code, /code-convert to translate between alpha-2, alpha-3 and numeric, /country-currency for the currency of a country or the countries using a currency, /calling-code to go from a dial code to countries, /country-languages for a country's languages, /name-normalise to map names like USA or U.S. to ISO codes, /currency-info for ISO 4217 details, and /us-state-code for US state and territory postal codes. Each paid GET returns a computed verdict with the reasons, the source and what was NOT checked. A verdict of UNVERIFIED means a lookup failed: treat it as unknown. No account or key: pay per call in USDC over x402."},"servers":[{"url":"https://country-codes-iso.x402tookit.com"}],"paths":{"/calling-code":{"get":{"operationId":"calling_code","summary":"Country for an ITU E.164 calling code or international number prefix, such as +44 or +1 876; flags shared codes.","description":"Country for an ITU E.164 calling code or international number prefix, such as +44 or +1 876; flags shared codes.","tags":["e164","calling-code","itu","country-codes"],"parameters":[{"name":"code","in":"query","required":true,"description":"Calling code or number prefix: +44, 1876, +49 30 1234","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"input":{"type":["null","string"]},"callingCode":{"type":["null","string"]},"countries":{"type":["array","null"],"items":{"type":"object","properties":{"alpha2":{"type":["null","string"]},"name":{"type":["null","string"]}}}},"sharedWithAll":{"type":["array","null"],"items":{"type":"object","properties":{"alpha2":{"type":["null","string"]},"name":{"type":["null","string"]}}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"MATCH","summary":"+1 876 belongs to Jamaica (JM).","reasons":["Narrowed by the territory prefix after +1."],"input":"+1 876","callingCode":"+1","countries":[{"alpha2":"JM","name":"Jamaica"}],"sharedWithAll":[{"alpha2":"AG","name":"Antigua & Barbuda"},{"alpha2":"AI","name":"Anguilla"}],"attribution":"Tables built 2026-10-11 from datasets/country-codes, datasets/currency-codes, datasets/language-codes and Unicode CLDR; cross-checked against Wikidata (CC0).","degraded":false,"notChecked":["whether a full number is dialable or assigned","area codes inside shared plans beyond the territory prefixes in the source (US and Canada share +1 and cannot be told apart here)","…1 more"],"source":"Embedded ISO 3166-1, ISO 4217 and ISO 639 tables (see lib header for sources)","asOf":"2026-10-11T08:53:23.457Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/calling-code"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/calling-code"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/calling-code"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/calling-code"}}]}}},"/code-convert":{"get":{"operationId":"code_convert","summary":"Convert an ISO 3166-1 country code between alpha-2, alpha-3 and numeric; also name, currency, ccTLD, calling code.","description":"Convert an ISO 3166-1 country code between alpha-2, alpha-3 and numeric; also name, currency, ccTLD, calling code.","tags":["iso-3166","convert","country-codes"],"parameters":[{"name":"code","in":"query","required":true,"description":"Country code in any form: US, USA or 840","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"Target: all (default), alpha2, alpha3, numeric, name, currency, tld or calling","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"input":{"type":["null","string"]},"from":{"type":["null","string"]},"to":{"type":["null","string"]},"result":{"type":["null","object"],"properties":{"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"numeric":{"type":["null","string"]},"name":{"type":["null","string"]}}},"country":{"type":["null","object"],"properties":{"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"numeric":{"type":["null","string"]},"name":{"type":["null","string"]},"officialName":{"type":["null","string"]},"region":{"type":["null","string"]},"subRegion":{"type":["null","string"]},"capital":{"type":["null","string"]},"currencies":{"type":["array","null"],"items":{"type":"string"}},"callingCodes":{"type":["array","null"],"items":{"type":"string"}},"tld":{"type":["null","string"]},"independent":{"type":["boolean","null"]}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"CONVERTED","summary":"USA = US / USA / 840 (US).","reasons":[],"input":"USA","from":"alpha3","to":"all","result":{"alpha2":"US","alpha3":"USA","numeric":"840","name":"US"},"country":{"alpha2":"US","alpha3":"USA","numeric":"840","name":"US","officialName":"United States of America","region":"Americas","subRegion":"Northern America","capital":"Washington","currencies":["USD"],"callingCodes":["+1"],"tld":".us","independent":true},"attribution":"Tables built 2026-10-11 from datasets/country-codes, datasets/currency-codes, datasets/language-codes and Unicode CLDR; cross-checked against Wikidata (CC0).","degraded":false,"notChecked":["names (use /name-normalise for free text)","deleted or reserved codes such as UK or AN (use /code-validate)","…1 more"],"source":"Embedded ISO 3166-1, ISO 4217 and ISO 639 tables (see lib header for sources)","asOf":"2026-10-11T08:53:23.712Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/code-convert"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/code-convert"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/code-convert"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/code-convert"}}]}}},"/code-lookup":{"get":{"operationId":"code_lookup","summary":"Look up a country, currency or language from any ISO code, TLD or name, with fuzzy matching and ambiguity flags.","description":"Look up a country, currency or language from any ISO code, TLD or name, with fuzzy matching and ambiguity flags.","tags":["iso-3166","country-codes","lookup","fuzzy"],"parameters":[{"name":"q","in":"query","required":true,"description":"A code or name: FR, FRA, 250, .fr, Germny, EUR, Spanish","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"auto (default), country, currency or language","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"kind":{"type":["null","string"]},"input":{"type":["null","string"]},"matches":{"type":["array","null"],"items":{"type":"object","properties":{"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"numeric":{"type":["null","string"]},"name":{"type":["null","string"]},"officialName":{"type":["null","string"]},"region":{"type":["null","string"]},"subRegion":{"type":["null","string"]},"capital":{"type":["null","string"]},"currencies":{"type":["array","null"],"items":{"type":"string"}},"callingCodes":{"type":["array","null"],"items":{"type":"string"}},"tld":{"type":["null","string"]},"independent":{"type":["boolean","null"]},"score":{"type":["null","number"]},"matchedOn":{"type":["null","string"]}}}},"otherInterpretations":{"type":["array","null"]},"subdivision":{},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FUZZY_MATCH","summary":"Germany: alpha-2 DE, alpha-3 DEU, numeric 276.","reasons":["Approximate match on spelling or partial words: confirm before relying on it."],"kind":"country","input":"Germny","matches":[{"alpha2":"DE","alpha3":"DEU","numeric":"276","name":"Germany","officialName":"Germany","region":"Europe","subRegion":"Western Europe","capital":"Berlin","currencies":["EUR"],"callingCodes":["+49"],"tld":".de","independent":true,"score":0.86,"matchedOn":"similar spelling"}],"otherInterpretations":[],"subdivision":null,"attribution":"Tables built 2026-10-11 from datasets/country-codes, datasets/currency-codes, datasets/language-codes and Unicode CLDR; cross-checked against Wikidata (CC0).","degraded":false,"notChecked":["whether a name is the right entity for your purpose (fuzzy matches are suggestions)","subdivisions (ISO 3166-2) and historical or deleted codes","…1 more"],"source":"Embedded ISO 3166-1, ISO 4217 and ISO 639 tables (see lib header for sources)","asOf":"2026-10-11T08:53:23.977Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/code-lookup"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/code-lookup"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/code-lookup"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/code-lookup"}}]}}},"/code-validate":{"get":{"operationId":"code_validate","summary":"Validate an ISO 3166-1, 4217 or 639 code or a ccTLD or dial code: assigned, reserved, deleted or unknown.","description":"Validate an ISO 3166-1, 4217 or 639 code or a ccTLD or dial code: assigned, reserved, deleted or unknown.","tags":["iso-3166","iso-4217","iso-639","validate"],"parameters":[{"name":"code","in":"query","required":true,"description":"The code to check, e.g. GB, EUR, 840, fr, .uk, +44","schema":{"type":"string"}},{"name":"kind","in":"query","required":true,"description":"One of: country-alpha2, country-alpha3, country-numeric, currency, currency-numeric, language-639-1, language-639-2, cctld, calling-code","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"code":{"type":["null","string"]},"kind":{"type":["null","string"]},"attribution":{"type":["null","string"]},"valid":{"type":["boolean","null"]},"normalised":{"type":["null","string"]},"note":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"NOT_ASSIGNED_RESERVED","summary":"UK is not an assigned ISO 3166-1 country code: exceptionally reserved for the United Kingdom; the assigned code is GB.","reasons":[],"code":"UK","kind":"country-alpha2","attribution":"Tables built 2026-10-11 from datasets/country-codes, datasets/currency-codes, datasets/language-codes and Unicode CLDR; cross-checked against Wikidata (CC0).","valid":false,"normalised":"UK","note":"exceptionally reserved for the United Kingdom; the assigned code is GB","degraded":false,"notChecked":["codes withdrawn from ISO 4217 long ago (the table holds the current list)","generic top-level domains","…1 more"],"source":"Embedded ISO 3166-1, ISO 4217 and ISO 639 tables (see lib header for sources)","asOf":"2026-10-11T08:53:24.236Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/code-validate"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/code-validate"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/code-validate"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/code-validate"}}]}}},"/country-currency":{"get":{"operationId":"country_currency","summary":"Currency of a country (code, number, minor units) or every country using a currency, by ISO 4217.","description":"Currency of a country (code, number, minor units) or every country using a currency, by ISO 4217.","tags":["iso-4217","currency","country-codes"],"parameters":[{"name":"q","in":"query","required":true,"description":"A country (name or code) or a currency code, e.g. Japan or EUR","schema":{"type":"string"}},{"name":"mode","in":"query","required":false,"description":"country, currency or auto (default)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"direction":{"type":["null","string"]},"currency":{"type":["null","object"],"properties":{"code":{"type":["null","string"]},"numeric":{"type":["null","string"]},"name":{"type":["null","string"]},"minorUnit":{"type":["null","number"]},"kind":{"type":["null","string"]}}},"countries":{"type":["array","null"],"items":{"type":"object","properties":{"alpha2":{"type":["null","string"]},"name":{"type":["null","string"]},"primary":{"type":["boolean","null"]}}}},"issuers":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"EUR (Euro) is used by 36 countries: AD, AT, AX, BE, BG, BL ....","reasons":[],"direction":"currency-to-countries","currency":{"code":"EUR","numeric":"978","name":"Euro","minorUnit":2,"kind":"currency"},"countries":[{"alpha2":"AD","name":"Andorra","primary":true},{"alpha2":"AT","name":"Austria","primary":true}],"issuers":["ÅLAND ISLANDS","ANDORRA","…35 more"],"attribution":"Tables built 2026-10-11 from datasets/country-codes, datasets/currency-codes, datasets/language-codes and Unicode CLDR; cross-checked against Wikidata (CC0).","degraded":false,"notChecked":["territories that use a foreign currency by arrangement and are not listed that way in the source","historical currencies and redenominations in progress","…1 more"],"source":"Embedded ISO 3166-1, ISO 4217 and ISO 639 tables (see lib header for sources)","asOf":"2026-10-11T08:53:24.500Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/country-currency"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/country-currency"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/country-currency"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/country-currency"}}]}}},"/country-languages":{"get":{"operationId":"country_languages","summary":"Languages listed for a country with ISO 639-1 and 639-2 codes and names, from a country name or ISO code.","description":"Languages listed for a country with ISO 639-1 and 639-2 codes and names, from a country name or ISO code.","tags":["iso-639","languages","country-codes"],"parameters":[{"name":"country","in":"query","required":true,"description":"Country name or ISO code, e.g. Switzerland or CH","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"country":{"type":["null","object"],"properties":{"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"numeric":{"type":["null","string"]},"name":{"type":["null","string"]},"officialName":{"type":["null","string"]},"region":{"type":["null","string"]},"subRegion":{"type":["null","string"]},"capital":{"type":["null","string"]},"currencies":{"type":["array","null"],"items":{"type":"string"}},"callingCodes":{"type":["array","null"],"items":{"type":"string"}},"tld":{"type":["null","string"]},"independent":{"type":["boolean","null"]}}},"languages":{"type":["array","null"],"items":{"type":"object","properties":{"tag":{"type":["null","string"]},"iso639_1":{"type":["null","string"]},"iso639_2":{"type":["null","string"]},"name":{"type":["null","string"]},"region":{"type":["null","string"]}}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"Switzerland (CH): German, French, Italian, Romansh.","reasons":["Order follows the source and is not a ranking."],"country":{"alpha2":"CH","alpha3":"CHE","numeric":"756","name":"Switzerland","officialName":"Switzerland","region":"Europe","subRegion":"Western Europe","capital":"Bern","currencies":["CHF"],"callingCodes":["+41"],"tld":".ch","independent":true},"languages":[{"tag":"de-CH","iso639_1":"de","iso639_2":"ger","name":"German","region":"CH"},{"tag":"fr-CH","iso639_1":"fr","iso639_2":"fre","name":"French","region":"CH"}],"attribution":"Tables built 2026-10-11 from datasets/country-codes, datasets/currency-codes, datasets/language-codes and Unicode CLDR; cross-checked against Wikidata (CC0).","degraded":false,"notChecked":["official status versus widely spoken (the source lists languages without status)","speaker counts or literacy","…1 more"],"source":"Embedded ISO 3166-1, ISO 4217 and ISO 639 tables (see lib header for sources)","asOf":"2026-10-11T08:53:24.762Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/country-languages"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/country-languages"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/country-languages"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/country-languages"}}]}}},"/currency-info":{"get":{"operationId":"currency_info","summary":"ISO 4217 currency details by code, number or name: minor units, issuers, countries; optional exact rounding of an amount.","description":"ISO 4217 currency details by code, number or name: minor units, issuers, countries; optional exact rounding of an amount.","tags":["iso-4217","currency","minor-units","rounding"],"parameters":[{"name":"q","in":"query","required":true,"description":"Currency code, number or name, e.g. JPY, 978 or Swiss franc","schema":{"type":"string"}},{"name":"amount","in":"query","required":false,"description":"Optional decimal amount to round to the currency's minor unit, e.g. 1.005","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"currency":{"type":["null","object"],"properties":{"code":{"type":["null","string"]},"numeric":{"type":["null","string"]},"name":{"type":["null","string"]},"minorUnit":{"type":["null","number"]},"kind":{"type":["null","string"]},"issuers":{"type":["array","null"],"items":{"type":"string"}},"countries":{"type":["array","null"],"items":{"type":"object","properties":{"alpha2":{"type":["null","string"]},"name":{"type":["null","string"]}}}}}},"matchedOn":{"type":["null","string"]},"attribution":{"type":["null","string"]},"rounding":{"type":["null","object"],"properties":{"input":{"type":["null","string"]},"minorUnit":{"type":["null","number"]},"rounded":{"type":["null","string"]},"method":{"type":["null","string"]}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"JPY (392): Yen, 0 decimal places; 12.5 rounds to 13.","reasons":[],"currency":{"code":"JPY","numeric":"392","name":"Yen","minorUnit":0,"kind":"currency","issuers":["JAPAN"],"countries":[{"alpha2":"JP","name":"Japan"}]},"matchedOn":"code","attribution":"Tables built 2026-10-11 from datasets/country-codes, datasets/currency-codes, datasets/language-codes and Unicode CLDR; cross-checked against Wikidata (CC0).","rounding":{"input":"12.5","minorUnit":0,"rounded":"13","method":"half away from zero on the exact decimal, no floating point"},"degraded":false,"notChecked":["exchange rates","cash-rounding rules that differ from the minor unit (for example 5 cent rounding)","…1 more"],"source":"Embedded ISO 3166-1, ISO 4217 and ISO 639 tables (see lib header for sources)","asOf":"2026-10-11T08:53:25.026Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/currency-info"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/currency-info"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/currency-info"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/currency-info"}}]}}},"/language-lookup":{"get":{"operationId":"language_lookup","summary":"Look up a language by ISO 639-1, 639-2 (B or T) code, BCP 47 tag or English name; returns all code forms.","description":"Look up a language by ISO 639-1, 639-2 (B or T) code, BCP 47 tag or English name; returns all code forms.","tags":["iso-639","languages","lookup"],"parameters":[{"name":"q","in":"query","required":true,"description":"Language code, tag or name: fr, fra, fre, pt-BR, Welsh","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"language":{"type":["null","object"],"properties":{"iso639_1":{"type":["null","string"]},"iso639_2":{"type":["null","string"]},"iso639_2T":{"type":["null","string"]},"names":{"type":["array","null"],"items":{"type":"string"}}}},"matchedOn":{"type":["null","string"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"MATCH","summary":"French: ISO 639-2 fre (terminological fra), ISO 639-1 fr.","reasons":["This language has two ISO 639-2 codes: bibliographic (B) and terminological (T); ISO 639-1 and BCP 47 follow the two-letter code."],"language":{"iso639_1":"fr","iso639_2":"fre","iso639_2T":"fra","names":["French"]},"matchedOn":"ISO 639-2 code","attribution":"Tables built 2026-10-11 from datasets/country-codes, datasets/currency-codes, datasets/language-codes and Unicode CLDR; cross-checked against Wikidata (CC0).","degraded":false,"notChecked":["ISO 639-3 languages beyond the 639-2 list","dialects, scripts and regional variants (only the language subtag of a tag is read)","…1 more"],"source":"Embedded ISO 3166-1, ISO 4217 and ISO 639 tables (see lib header for sources)","asOf":"2026-10-11T08:53:25.288Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/language-lookup"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/language-lookup"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/language-lookup"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/language-lookup"}}]}}},"/name-normalise":{"get":{"operationId":"name_normalise","summary":"Normalise country names like USA, U.S. or United States of America to ISO codes; up to 25 per call, with confidence.","description":"Normalise country names like USA, U.S. or United States of America to ISO codes; up to 25 per call, with confidence.","tags":["country-names","normalize","iso-3166","fuzzy"],"parameters":[{"name":"names","in":"query","required":true,"description":"Names separated by | or new lines, e.g. USA|U.S.|Deutschland","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"results":{"type":["array","null"],"items":{"type":"object","properties":{"input":{"type":["null","string"]},"status":{"type":["null","string"]},"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"name":{"type":["null","string"]},"confidence":{"type":["null","number"]},"matchedOn":{"type":["null","string"]}}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"ALL_MATCHED","summary":"5 of 5 names matched exactly.","reasons":[],"results":[{"input":"USA","status":"MATCH","alpha2":"US","alpha3":"USA","name":"US","confidence":1,"matchedOn":"ISO 3166-1 alpha-3 code"},{"input":"U.S.","status":"MATCH","alpha2":"US","alpha3":"USA","name":"US","confidence":1,"matchedOn":"exact alias"}],"attribution":"Tables built 2026-10-11 from datasets/country-codes, datasets/currency-codes, datasets/language-codes and Unicode CLDR; cross-checked against Wikidata (CC0).","degraded":false,"notChecked":["whether the name means the country or something else (Georgia, Jordan, Guinea, Congo)","subdivisions such as England or Texas","…1 more"],"source":"Embedded ISO 3166-1, ISO 4217 and ISO 639 tables (see lib header for sources)","asOf":"2026-10-11T08:53:25.548Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/name-normalise"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/name-normalise"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/name-normalise"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/name-normalise"}}]}}},"/us-state-code":{"get":{"operationId":"us_state_code","summary":"US state, DC and territory lookup by USPS postal code, name or FIPS number; returns all three plus the type.","description":"US state, DC and territory lookup by USPS postal code, name or FIPS number; returns all three plus the type.","tags":["us-states","usps","fips","reference"],"parameters":[{"name":"q","in":"query","required":true,"description":"Postal code, name or FIPS: CO, Colorado, 08","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"state":{"type":["null","object"],"properties":{"postal":{"type":["null","string"]},"name":{"type":["null","string"]},"fips":{"type":["null","string"]},"kind":{"type":["null","string"]}}},"matchedOn":{"type":["null","string"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"MATCH","summary":"Colorado: postal CO, FIPS 08, state.","reasons":[],"state":{"postal":"CO","name":"Colorado","fips":"08","kind":"state"},"matchedOn":"name","attribution":"Tables built 2026-10-11 from datasets/country-codes, datasets/currency-codes, datasets/language-codes and Unicode CLDR; cross-checked against Wikidata (CC0).","degraded":false,"notChecked":["counties, cities and ZIP codes","ISO 3166-2:US codes (US-CO) which share the postal letters for states","…1 more"],"source":"Embedded ISO 3166-1, ISO 4217 and ISO 639 tables (see lib header for sources)","asOf":"2026-10-11T08:53:25.811Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/us-state-code"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/us-state-code"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/us-state-code"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://country-codes-iso.x402tookit.com/us-state-code"}}]}}}}}