{"id":"idna-domain-to-unicode","version":"1.0.0","description":"Convert a domain to Unicode with UTS #46 ToUnicode and decode A-labels.","supported_operations":["convert punycode domain to unicode","uts 46 tounicode","a-label back to unicode letters","decode an xn domain","unicode display form of a domain","idna domain to unicode letters","show the unicode labels of a domain"],"unsupported_operations":["look up the domain in dns","convert a url path to unicode","enforce the 253 octet dns limit"],"semantics":["Map each code point by Unicode 17.0.0 IdnaMappingTable status. Ignored code points are removed. Disallowed and valid code points stay. Deviation code points use the table mapping only when transitional is true; otherwise they stay. Mapped code points use the table mapping, except U+1E9E CAPITAL SHARP S, which becomes U+0073 U+0073 (ss) when transitional is true and U+00DF when transitional is false (UTS #46 revision 33, section 4 step 1).","After mapping, normalize with NFC. The host String.normalize and the Mark category check follow the runtime Unicode version; status values come only from the vendored Unicode 17.0.0 table.","transitional is optional. When the field is omitted, transitional processing is false and the output echoes false. data_version is unicode-17.0.0-uts46-rev33.","CheckBidi and CheckJoiners are not applied. NV8 and XV8 markers are not an extra rejection. There is no DNS lookup and no URL parse.","Disclaimer: format transform only; provides no confidentiality, integrity, or authenticity.","ToUnicode (section 4.3) uses the same Map, NFC, and Validate steps as ToASCII, including STD3 and CheckHyphens, then returns the Unicode labels. It does not punycode them and it does not apply VerifyDnsLength.","An xn-- label is decoded and validated under nontransitional rules. It is not remapped, so transitional true does not turn xn--fa-hia.de into fass.de. A trailing empty root label is kept. A label longer than 63 octets can still succeed.","The first failure wins: not_nfc, hyphen, combining_mark, disallowed, std3, punycode, empty_label. Those are invalid_input with details.reason. This tool does not return domain_too_long or label_too_long.","Input longer than 253 UTF-16 code units, or whose UTF-8 form exceeds 253 bytes, is limit_exceeded before mapping and before the lone-surrogate check."],"limits":{"max_input_bytes":253},"pricing":{"status":"unpriced","charge_usd":null},"input_schema":{"type":"object","additionalProperties":false,"required":["domain"],"properties":{"domain":{"type":"string","minLength":1,"description":"Domain name, without a scheme or path. Omitted transitional means false."},"transitional":{"type":"boolean","description":"UTS #46 Transitional_Processing. Omission means false."}}},"output_schema":{"type":"object","additionalProperties":false,"required":["unicode","transitional","data_version"],"properties":{"transitional":{"type":"boolean"},"data_version":{"type":"string","const":"unicode-17.0.0-uts46-rev33"},"unicode":{"type":"string","minLength":1}}},"examples":[{"input":{"domain":"xn--bcher-kva.de"},"output":{"unicode":"bücher.de","transitional":false,"data_version":"unicode-17.0.0-uts46-rev33"}},{"input":{"domain":"FAẞ.de","transitional":true},"output":{"unicode":"fass.de","transitional":true,"data_version":"unicode-17.0.0-uts46-rev33"}},{"input":{"domain":"xn--blo-7ka.de","transitional":true},"output":{"unicode":"bloß.de","transitional":true,"data_version":"unicode-17.0.0-uts46-rev33"}}],"execute_url":"/v1/tools/idna-domain-to-unicode/versions/1.0.0/execute"}