Skip to content
  • Contribution
  • Data Retriever
  • Global Address Verification
  • Address Verification
  • Verify addresses
    post
  • Global Email
  • Global Express Entry
  • Global IP
  • Global Name
  • Global Phone
  • LeadGen - Business
  • LeadGen - Consumer
  • LeadGen - Occupant
  • LeadGen - Property
  • Melissa Releases
  • People Business Search
  • Personator Consumer
  • Personator Identity
  • Personator Search
  • Property
  • Reverse GeoCoder
  • SmartMover CA
  • SmartMover US
  • SSN Name Match
  • Street Route
  • Token Server
  • US Business Coder
  • Usage

    • Verify an address

    Request

    Use this endpoint to submit a request to verify or standardize a global address.

    Query
    formatstringrequired

    Format of the request.

    Default:"xml"
    Enum:"json""xml"
    Example:format=json
    idstringrequired

    Required. The License Key issued by Melissa.

    Example:id=REPLACE-WITH-YOUR-LICENSE-KEY
    optstring

    Options - Specify which options to use for the selected action. List of options in OptionName:Parameter format. Multiple options are delimited with a ,.

    For example: OptionName:Parameter,OptionName:Parameter.

    • AreaDetails:< ON | OFF > - This option appends regional classification codes to the Extras section. Default of off has no regional classification codes included in the response.
    • CountryOfOrigin:<ISO2, ISO3, or ISO#> - This is used to determine whether or not to include the country name as the last line in FormattedAddress.
    • DeliveryLines:< ON | OFF > - This options allows you to specify if the Address Lines 1-8 should contain just the delivery address or the entire address. Default of off has Address Lines 1-8 return the entire address.
    • DetailedResults:< ON | OFF > - This is for users that have experience or code using Address Object and would like to have those codes alongside the Global Address result codes. Default of OFF will not return extra result codes.
    • ExtendedDateTime:< ON | OFF > - Additional information related to time zone names and UTC information for both standard and daylight savings will be made available in the Extras section. Default of OFF will not provide additional output information.
    • GBExtras:< ON | OFF > - Allows you to choose to add the UPRN output. Default of OFF will not provide additional output information.
    • IncludeRemnant:< ON | OFF > - In cases where Global Address identifies a piece of the input as extra information, we label this as Remnant and can append it to the beginning of the address lines. Default of ON will append remnant (extra information) to the beginning of the address lines.
    • LineSeparator:< SEMICOLON | PIPE | CR | LF | CRLF | TAB | BR> - This is the line separator used for the FormattedAddress result. Default of SEMICOLON uses a semicolon (;).
    • MelissaCityKeys:< ON | OFF > - When this option is enabled, ID fields representing a unique combination of ZIP Code, City, County, State, and Country will be appended to the Extras section. Currently available for the US. Default of OFF will not provide additional output information.
    • OriginDateTime:< String with UTC data > - (BETA) A string DateTime value with UTC data to use in the calculation of the local date time. For example: OriginDateTime:2022-01-13 18:33:16 (UTC-8:00).
    • OutputGeo:< ON | OFF > - Allows you to specify if you want geocoding output in the response. Default of ON will return latitude and longitude when available.
    • OutputScript:< NOCHANGE | LATN | NATIVE > - This is the script type used for all applicable fields. Default of NOCHANGE will return the same script that is sent in.
    • Suggestion:< ON | OFF > - (BETA) Available only for single-record requests. In cases where Global Address cannot fully verify an address, alternate suggestions may be returned in the Suggestions response field. Default of OFF will not provide alternate address suggestions.
    • USExtras:< ON | OFF > - These are additional US only output will that can be made available in the Extras section. These outputs are related to Census, County, and School information. Default of OFF will not provide additional output information.
    • USPreferredCityNames:< ON | OFF > Allows you to override the city name and return only the USPS preferred city name. Default of OFF will leave valid vanity city names as preferred by the USPS.
    • USStandardizationType:< Auto | Short | Long > Allows you to specify the standardization of the address abbreviation. Default of Short will leave the US address in short abbreviated form as preferred by the USPS.
    Example:opt=CountryOfOrigin:USA,DeliveryLines:On,DetailedResults:ON
    tstring

    This is a string value that serves as a unique identifier for this set of records. It is returned as sent.

    Example:t=Test
    a1stringrequired

    Required. The input field for the address. This should contain the delivery address information (house number, thoroughfare, building, suite, etc.) but should not contain locality information (locality, administrative area, postal code, etc.) which have their own inputs.

    Example:a1=22382 Avenida Empresa
    a2string

    The input field for the address.

    a3string

    The input field for the address.

    a4string

    The input field for the address.

    a5string

    The input field for the address.

    a6string

    The input field for the address.

    a7string

    The input field for the address.

    a8string

    The input field for the address.

    admareastringrequired

    Required. State, Province. The most common geographic data element.

    Example:admarea=CA
    ctrystringrequired

    Required. The country name, abbreviation, or code.

    Example:ctry=USA
    ddeplocstring

    The smallest population center data element. This depends on the Locality and DependentLocality elements.

    deplocstring

    Urbanization. The smaller population center data element. This depends on the Locality element. In terms of US Addresses, this element applies only to Puerto Rican addresses. It is used to break ties when a ZIP Code is linked to multiple instances of the same address.

    laststring

    US Only. For addresses missing a secondary like a suite or apartment, we can use the last name and append that information for residential addresses.

    locstringrequired

    Required. City, Municipality. The most common population center data element.

    Example:loc=Rancho Santa Margarita
    orgstring

    The organization name associated with the address record.

    postalstringrequired

    Required. ZIP, Postcode. The complete postal code for a particular delivery point. If all three elements are provided and the PostalCode is incorrect, it can be corrected from the data on the Locality and AdministrativeArea.

    Example:postal=92688
    subadmareastring

    County. The smallest geographic data element.

    subnatareastring

    The administrative region within a country on an arbitrary level below that of the sovereign state.

    Headers
    Acceptstringrequired

    Format of the response.

    Enum:"application/json""*/*"
    Example:*/*
    Content-Typestringrequired

    Format of the request.

    Enum:"application/json""application/xml"
    curl -i -X GET \
  'https://address.melissadata.net/V3/WEB/GlobalAddress/doGlobalAddress?format=JSON&id=REPLACE-WITH-YOUR-LICENSE-KEY&a1=22382+Avenida+Empresa&admarea=CA&ctry=USA&loc=Rancho+Santa+Margarita&postal=92688' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json'

    Responses

    Successful response

    Body
    Versionstring

    The current service version number.

    TransmissionReferencestring

    Serves as a unique request identifier.

    TransmissionResultsstring

    Lists error codes from any errors caused by the most recent request as a whole. For more information, see Global Address Verification Result Codes.

    TotalRecordsstring

    Total number of records.

    RecordsArray of objects
    Response
    {
  "Version": "3.0.1.174",
  "TransmissionReference": "Test",
  "TransmissionResults": "",
  "TotalRecords": "1",
  "Records": [
    { … }
  ]
}