Quickstart#

Introduction#

Welcome to the Melissa Data Global Name Service. Parse, genderize, and standardize personal names as well as able to standardize company names.

Global Name can be used to:

  • Recognize over 6,000,000 last names and 4,000,000 first names across different countries and languages.

  • Parse full names into first, middle and last names, as well as prefixes like “Dr.” and suffixes like “Jr.”

  • Correct misspelled first names

  • Standardized names with extended and UTF-8 characters will return responses with the proper UTF-8 / accented characters.

  • Flag vulgar and obviously fake names, such as “Bugs Bunny.”

  • Split dual names (ex. Mr and Mrs John and Mary Jones)

  • Assign gender based on known first names and prefixes.

  • Output preferred output Salutation name parts.

  • Standardize company names

System Requirements#

  • SSL/TLS 1.2+

Getting Started - What Can I Do?#

Check a Name#

Global Name can check to see if a given name is valid.

Endpoint#

/V3/WEB/GlobalName/doGlobalName

Click here to go to the full endpoint documentation.

Try it Now#

  • GET JSON
  • POST JSON
  • GET XML
  • POST XML
curl -X GET "https://globalname.melissadata.net/V3/WEB/GlobalName/doGlobalName?\
id={{customerId}}\
&full=Doktor%20Enna%20Sch%C3%A4fer&ctry=DE\
&t=Global%20Name%20CurlExample"\
-H "Content-Type: application/json"\
-H "Accept: application/json"
  curl -X POST "https://globalname.melissadata.net/V3/WEB/GlobalName/doGlobalName?" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
      "TransmissionReference": "JSON Global Name Test",
      "CustomerID": {{customerId}},
      "Options": "",
      "Records": [
          {
              "RecordID": "1",
              "Country": "DE",
              "FullName": "Doktor Enna Schäfer"
          },
          {
              "RecordID": "2",
              "Country": "US",
              "FullName": "Ray Melissa"
          }
      ]
    }'
  curl -X GET "https://globalname.melissadata.net/V3/WEB/GlobalName/doGlobalName?\
  id={{customerId}}\
  &full=Doktor%20Enna%20Sch%C3%A4fer&ctry=DE\
  &t=Global%20Name%20CurlExample"\
  -H "Content-Type: application/xml"\
  -H "Accept: application/xml"
  curl -X POST "https://globalname.melissadata.net/V3/WEB/GlobalName/doGlobalName?" \
  -H "Content-Type: application/xml" \
  -H "Accept: application/xml" \
  -d '<Request>
        <TransmissionReference>XML Global Name Test</TransmissionReference>
        <CustomerID>{{customerId}}</CustomerID>
        <Options></Options>
        <Records>
          <RequestRecord>
              <RecordID>1</RecordID>
              <Country>DE</Country>
              <FullName>Doktor Enna Schäfer</FullName>
          </RequestRecord>
          <RequestRecord>
              <RecordID>2</RecordID>
              <Country>US</Country>
              <FullName>Ray Melissa</FullName>
          </RequestRecord>
        </Records>
      </Request>'

Sample Code#

Language

Repository

C# .NET

melissa_favicon MelissaData/GlobalName-Dotnet

Python3

melissa_favicon MelissaData/GlobalName-Python3

Postman Collection

melissa_favicon MelissaData/GlobalName-Postman