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

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

• 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&format=json\
&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\u00E4fer"
        },
        {
            "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&format=xml\
&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\u00E4fer</FullName>
        </RequestRecord>
        <RequestRecord>
            <RecordID>2</RecordID>
            <Country>US</Country>
            <FullName>Ray Melissa</FullName>
        </RequestRecord>
      </Records>
    </Request>'

Sample Code

Language	Repository
C# .NET	MelissaData/GlobalName-Dotnet
Python3	MelissaData/GlobalName-Python3
Postman Collection	MelissaData/GlobalName-Postman