{"id":"email-mailbox-validate","version":"1.0.0","description":"Check one RFC 5322 mailbox for syntax only and return a stable reason code.","supported_operations":["validate rfc 5322 mailbox syntax","check one mailbox grammar only","mailbox syntax reason without dns","reject obsolete mailbox phrase dots","is this single mailbox syntactically valid","detect unclosed mailbox quotes","בדיקת תחביר של תיבת דואר"],"unsupported_operations":["return the display-name word list","claim the address exists or can receive mail","validate SPF DKIM or DMARC","validate a comma-separated address list"],"semantics":["Well-typed mailbox text that fails RFC 5322 syntax returns {valid:false, reason}. It does not throw. Wrong types, unknown fields, lone surrogates, and declared limits throw. The grammar matches email-mailbox-parse: phrase words, dot-atom, quoted-string, comments, and domain-literals; obsolete dots in a display name are invalid_display_name.","A valid result returns form and canonical text using the same canonical quoting as the parser. utf8 defaults to false. true selects RFC 6532 UTF-8 scalars without normalization. No DNS lookup and no deliverability claim.","reason is one of: non_ascii, invalid_local_part, invalid_domain, invalid_domain_literal, invalid_display_name, invalid_quoted_string, invalid_comment, obsolete_route, not_a_single_mailbox, unclosed_quote, unclosed_comment, unclosed_domain_literal, unclosed_angle, invalid_quoted_pair, trailing_junk."],"limits":{"max_mailbox_bytes":256,"max_local_part_chars":64,"max_domain_chars":190,"max_display_words":8,"max_word_chars":64,"max_comment_depth":4,"max_comments":8,"max_output_bytes":2048},"pricing":{"status":"unpriced","charge_usd":null},"input_schema":{"type":"object","additionalProperties":false,"required":["mailbox"],"properties":{"mailbox":{"type":"string","minLength":1,"maxLength":256},"utf8":{"type":"boolean"}}},"output_schema":{"type":"object","additionalProperties":false,"required":["valid"],"properties":{"valid":{"type":"boolean"},"reason":{"type":"string","enum":["non_ascii","invalid_local_part","invalid_domain","invalid_domain_literal","invalid_display_name","invalid_quoted_string","invalid_comment","obsolete_route","not_a_single_mailbox","unclosed_quote","unclosed_comment","unclosed_domain_literal","unclosed_angle","invalid_quoted_pair","trailing_junk"]},"form":{"type":"string","enum":["addr-spec","name-addr"]},"canonical":{"type":"string","minLength":3,"maxLength":1600}}},"examples":[{"input":{"mailbox":"Who? <one@y.test>"},"output":{"valid":true,"form":"name-addr","canonical":"Who? <one@y.test>"}},{"input":{"mailbox":"Joe Q. Public <x@y>"},"output":{"valid":false,"reason":"invalid_display_name"}},{"input":{"mailbox":"jdoe@example.org"},"output":{"valid":true,"form":"addr-spec","canonical":"jdoe@example.org"}}],"execute_url":"/v1/tools/email-mailbox-validate/versions/1.0.0/execute"}