NameAPI is a web API
to handle people's names
in your software.

News

30.11.2017

Version 5.3 Deployed

New version 5.3 available.


15.11.2017

Version 5.3 release candidate is online

More names, more cultures and a new web service: Risk Detector.


16.03.2017

Version 5.2 Deployed

As announced, the new version has been installed.


02.03.2017

Version 5.2 release candidate is online

More names, more cultures.


01.11.2016

Version 5.1 Deployed

As announced, the new version has been installed.


   

Name Formatter


       
Formats a full name nicely, with correct upper/lower case.
See also the Swagger specification.
            
"jean-claude LAFORGE" => "Jean-Claude Laforge"
                  
application/json (you must set the content-type as http header)
     
POST
       

   

Input

               
See Context.
   
{
  "context" : {
    "priority" : "REALTIME",
    "properties" : [ ]
  },
 "inputPerson" : {
    "type" : "NaturalInputPerson",
    "personName" : {
      "nameFields" : [ {
        "string" : "PETER",
        "fieldType" : "GIVENNAME"
      }, {
        "string" : "VAN DER SAR",
        "fieldType" : "SURNAME"
      } ]
    },
    "gender" : "UNKNOWN"
  }
}
     
   

   

Output

       
The nicely formatted string, possibly the same as the input.
       
If true then server didn't understand the input, but still tried to format it. This feature must be enabled specifically in the input properties.
   
{
  "formatted" : "Peter van der Sar",
  "unknown" : false
}