Welcome to Guardpost


                                                                :+++':.`
                                                                +'++++++++++':.`
                                                               +''++++++++++'''''+++';,
                                                              ,''+'++++++++++'++++++'+'`
                                                              +'+'''+''''++++++++++++'''
                                                             ++++''''''+++++++++++++'''';
                                                            .++++++++++''''''+++++++'''''`
                                                            #+++++++++++++++++'''''''''''+
                                                           '+++++++++++++++++++++++''''''';
                                                          .'''++'+++++++++++++++++''''#''''`
                                                          #++++'''''++'+++++++++++''''#+''''
                                                         '+++++++++++'''''+++++++''''###'''':
                                                        `+++++++++++++++++''''++'''''++##''''`
                                                        ++'++++++++++++++++++++'''''+++##+'''+
                                                       ;+''''++++++++++++++++++''''+++++##'''':
                                                      `++++++''''+++++++++++++''''''+++####''''`
                                                      ++++++++++++'''''+'+++++''''##'+#####+''''
                                                     :'+++++++++++++++''''+++''''###########'''':
                                                     '+++++++++++++++++++++'''''+#########@#+''''`
                                                    #++'''+'++++++++++++++++''''#########',;#+''''
                                                   :+++++++'''''''+++++++++''''`+#######..,:+#'''':
                                                   ++++++++++++'''++++++++'''':  ;####'....,:#+''''`
                                                  +''++++++++++++++''+++++''''     ##; `...,:;#+''''
                                                 ,'''+'+++++++++++++++'''''''`      .   ....'+'#'''':
                                                 #+++'''''+++++++++++++++''''            .,+'++##''''
                                                ++++++++'''+'+++++++++++''''''           '''''+'#+''''
                                               .'++++++++++'''+++++++++''''''''`       `;;''''++'#'''':
                                               ++++++++++++++++''''+++'''''''''':     `';;;'''+####''''
                                              '+''++++++++++++++++'''+''''''';;;;'.  .;;;;;''####'#+''''
                                             .+++++'''+++++++++++++++''''++;';;;;;;:,;;;;;;'#####@;#'''',
                                             ++++++++'''+++++++++++++''''##+;;;;;;;;;;;;;;########'++''''
                                            ''++++++++++''++++++++++''''#####;;;;;;;;;;;;########.,;#+''''
                                            '+'++++++++++++''++++++''''+######';;'#@@@@@#######;`.,:;+'''':
                                              :+++'+++++++++++'''++''''@########@@@@@@@@@@####`.....;#+''''
                                                `'+'+++++++++++++'''''` +######@@@@@@@@@@@@#,   ....'#++''';
                                                   +++++++++++++++''';`  ,###@@@@@@@@@@@@@@@:   ``.;:`;+''.
                                                   +';'++''++++++''''     `##@@@@@@@@@@@@@@#@    .+',
                                                   +'+,,:+++++++''''.      `@@@@@@@@@@@@@@@@@'  ,;'',
                                                   #'';,,:#++++''''':      @@@@@@@@@@@@@@@@@@@ ;;;;',
                                                   @''+...#+.:+''''+;'`   `@@@@@@@@@@@@@@@@@@#;;;;;',
                                                   @#'''..,..,,,;'++;;',  +@@@@@@@@@@@@@@@@@@@;;;;;;.
                                                   @#'''.......,+++';;;;; @@@@@@@@@@@@@@@@@@@#';;;;#.
                                                   @##'''.....,+'''';;;;;;@@@@@@@@@@@@@@@@@@@@';;'##.
                                                   ;##''',...,+''''';;;;;;@@@@@@@@@@@@@@@@@@@@';#+##`
                                                   `###'''..,''''''+';;;;'@@@@@@@@@@@@@@@@@@@@+#####`
                                                   .:##+'',.+'''''####;;;'@@@@@@@@@@@@@@@@@@@#######`
                                                   ``###'''''''''######';'@@@@@@@@@@@@@@@@@@@@#####+
                                                   ``,##+'''''''########+'@@@@@@@@@@@@@@@@@@@#####, `
                                                   .``###''''''###########@@@@@@@@@@@@@@@@@@@@###
                                                   '``,##+''''############@@@@@@@@@@@@@@@@@@@@#:
                                                   ;.``###'''######,'#####@@@@@@@@@@@@@@@@@@@@.
                                                   ;'``.###'######.. .####@@@@@@@@@@@@@@@@@@@#`
                                                   ;',``+########.`.   '##@@@@@@@@@@@@@@@@@@@@`    :
                                                   ;''```#######.```    .#@@@@@@@@@@@@@@@@@@@@   `';
                                                   ;'',``+#####`````     `@@@@@@@@@@@@@@@@@@@@  ,;;;
                                                   ;'''```###+``````     `@@@@@@@@@@@@@@@@@@@@ ;;;;;
                                                   ;#'',``'#'``````,`    `@@@@@@@@@@@@@@@@@@@@;;;;;;
                                                   :#'''```;``````:';,   `@@@@@@@@@@@@@@@@@@@@;;;;;;
                                                   :##'':````````;'';;;` `@@@@@@@@@@@@@@@@@@@@;;;;'#
                                                   .##'''```````'''';;;;:`@@@@@@@@@@@@@@@@@@@@;;;+##
                                                    ###'':````.''''';;;;;;@@@@@@@@@@@@@@@@@@@@;;####
                                                   `.##'''```.'''''';;;;;;@@@@@@@@@@@@@@@@@@@@'#####
                                                   ``###'';`,''''''';;;;;;@@@@@@@@@@@@@@@@@@@@######
                                                    `.##''';''''''+##';;;;@@@@@@@@@@@@@@@@@@@@#####.
                                                    ``###''''''''+#####;;;@@@@@@@@@@@@@@@@@@@@###+
                                                   ```.##+''''''########+;@@@@@@@@@@@@@@@@@@@###:
                                                   `;``###'''''###########@@@@@@@@@@@@@@@@@@@##.
                                                    '``.##+''+############@@@@@@@@@@@@@@@@@@@@`
                                                    ';``+##'+######'+#####@@@@@@@@@@@@@@@@@@@@     `
                                                    ''```#########:` .####@@@@@@@@@@@@@@@@@@@@    ,;
                                                    '';``+#######```   ;##@@@@@@@@@@@@@@@@@@@@   ;;;
                                                    +''```#####'````     +@@@@@@@@@@@@@@@@@@@@ `;;;;
                                                    #'';``+###:`````      @@@@@@@@@@@@@@@@@@@@`;;;;;
                                                    #+''```##```````      @@@@@@@@@@@@@@@@@@@@;;;;;;
                                                    ##'';``'```````.`     @@@@@@@@@@@@@@@@@@@@;;;;;+
                                                    ##+''`````````;';;    @@@@@@@@@@@@@@@@@@@@;;;'#+
                                                    ,##'';``````.''';;;,  @@@@@@@@@@@@@@@@@@@@;;'##+
                                                    `##+''`````:'''';;;;;.@@@@@@@@@@@@@@@@@@@@;+###'
                      ````.`...............`        .,##'';```'''''';;;;;;@@@@@@@@@@@@@@@@@@@@#####'
   ..........................................       .`##+''`,''''''';;;;;;@@@@@@@@@@@@@@@@@@@@#####,
  `..............................................`` ..:##''''''''''+';;;;;@@@@@@@@@@@@@@@@@@@@##+# `
  `.................................................'.`##+''''''''####';;;@@@@@@@@@@@@@@@@@@@@##+  `
  ..................................................+..:##''''''+#######;;@@@@@@@@@@@@@@@@@@@##'   `
  ..................................................';.`##+''''##########+@@@@@@@@@@@@@@@@@@@@:    `
  .................................................,''..:##''+############@@@######@@@@@@@@@@#     `
  ................................................,,+';.`@#+#########################@@@@@@@@#    :,`
   ..............................................,,,#+'..;#########. #################@@@@@@@#   :;,
    .............................................,,,#'';.`#######;``  `#################@@@@@#  ;;;,`
    `.........................................,,,,,,##++..;####+````    .#################@@@# ;;;;.`
     `.......................................,,,,,,:##+';..@##,`````      ################+#@+;;;;;.
      .......................................,,,,,,:;##++..;'..`````      ################+#@#;;;;',
       .....................................,,,,,,,::;+++;.....`````      ################+###;;;'#.
        ....................................,,,,,,,:::;'++,.....``,';,    ###+++++#+######+#@#;;+##.
         ...................................,,,,,,,,::::;+;,.....''';;;,  ##+++++++++++++++#@#;+###.`
          .................................,,,,,,,,,,,,:::+,,,.;'''';;;;;,:::::;;'+++++++++#@######``
          `...............................,,,,,,,,,,,,,,,::;:;+''''';;;;;;:::::::::,,,,,:;;'+@#;...``
           `...... ``.....................,,,,,,,,,,,,,,,,::;++''''';;;;;;:::::,,,,,,,,,,,,......```
            `.....         ``..............,,,,,,,,,,,,,,,,::;+++''+';;;;;::,,,,,,,,,........``````
             ..``                   `..,,.,..,,,,,,,,,,,,,,,::;'++####';'',,,,,,,,.........```````
                                            ``.,,,,,,,,,,,,,,::;'@######+',,,............`````````
                                                     `..,,,,,,:::;#######@...........```````````
                                                             `.,::;+#@',.....`````````````````
                                                                ` ```````````````````````````
                                                                        ``````````````````
                                                                                  `

Guardpost is an address validation service. Given an arbitrary address
guardpost validates address based off syntax checks (RFC defined grammar),
DNS validation, spell checks, and if available, Email Service Provider
(ESP) specific local-part grammar.

No addresses submitted to the guardpost service are ever stored on any
Rackspace servers. Nothing is persisted after the request is complete.
Basic Usage:

    * GET /validate

    Given an arbitrary address, validates address based off syntax checks, DNS
    validation, spell check, and if available, Email Service Provider (ESP)
    specific local-part grammar.

    ================= ==========================================================
    Parameter         Description
    ================= ==========================================================
    address           An email address to validate. (Maximum: 512 characters)
    api_key           If you can not use HTTP Basic Authentication (preferred),
                      you can pass your api_key in as a parameter.
    ================= ==========================================================

    Example:

        $ curl -G --user 'api:pubkey-5ogiflzbnjrljiky49qxsiozqef5jxp7' -G \
            https://api.mailgun.net/v2/address/validate \
            --data-urlencode address='foo@mailgun.net'

        {
            "is_valid": true,
            "address": "foo@mailgun.net",
            "parts": {
                "display_name": ""
                "local_part": "foo",
                "domain": "mailgun.net",
            },
            "did_you_mean": null
        }


    * GET /parse

    Parses a delimiter separated list of email addresses into two lists: parsed
    addresses and unparseable portions. The parsed addresses are a list of
    addresses that are syntactically valid (and optionally have DNS and ESP
    specific grammar checks) the unparseable list is a list of characters
    sequences that the parser was not able to understand. These often align with
    invalid email addresses, but not always.

    Delimiter characters are comma (,) and semicolon (;).

    ================= ==========================================================
    Parameter         Description
    ================= ==========================================================
    addresses         A delimiter separated list of addresses. (Maximum: 524288
                      characters)
    syntax_only       Perform only syntax checks or DNS and ESP specific
                      validation as well. (true by default)
    api_key           If you can not use HTTP Basic Authentication (preferred),
                      you can pass your api_key in as a parameter.
    ================= ==========================================================

    Example:

        $ curl -G --user 'api:pubkey-501jygdalut926-6mb1ozo8ay9crlc28' \
            https://api.mailgun.net/v2/address/parse \
            --data-urlencode addresses='Alice , \
            bob@example.com, example.com'

        {
            "parsed": [
                "Alice ",
                "bob@example.com"
            ],
            "unparseable": [
                "example.com"
            ]
        }