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

News

05.01.2026

2025 Around the World

2025 marked another remarkable year for Optimaize, characterized by significant progress in our...


15.12.2025

Detecting What Isn’t a Name: Salutations in International Data

Salutations often appear in name fields, even though they are not part of the actual name....


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.


   

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
}