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

News

30.10.2025

Software Version 11.0.0 Deployed

Release of Optimaize PII Platform with Java 21.


29.09.2025

Dictionary Update: Quechua and Aymara Names

The NameAPI database continues to grow, now enriched with 3,700 new given names and 600 family...


29.08.2025

Database Expansion: Brazilian Portuguese Names

We’ve expanded our database to include a comprehensive set of Brazilian Portuguese names. This...


21.08.2025

Secondary Domain Added: api.name-api.com for Enhanced Redundancy

To further strengthen NameAPI’s reliability and provide uninterrupted service access, we are happy...


28.07.2025

Version 10.8.0 Released

Release of Optimaize PII Platform, version 10.8.0.


   

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
       
We have integrated Swagger directly into our API.
Visit https://api.nameapi.org/rest/swagger-ui/.

   

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
}