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

News

25.11.2025

Dictionary Update: Danish Names

NameAPI has expanded its Nordic coverage with 2,600 given names and 8,600 family names, capturing...


05.11.2025

Verification of Payee (VoP) with NameMatcher

NameAPI is introducing Verification of Payee (VoP) powered by NameMatcher, enabling fast, accurate...


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...


   

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
}