Global Name Quickstart#
Introduction#
Welcome to the Melissa Global Name Cloud API. Parse, genderize, and standardize personal names as well as 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
New to Melissa Cloud APIs?#
We highly recommend first time users of our Cloud APIs to review our Using Melissa Cloud APIs section. It will cover critical topics like:
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#
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>'
Inputs and Outputs#
The table below shows the most common inputs and outputs for this endpoint.
For full details on the inputs see the Request Parameters and for a complete list of the outputs see the Response fields.
|
|
|
|
|
|
|
|