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

News

14.04.2025

Dictionary Update: Kyrgyz Names Added

We’ve expanded our database with a rich collection of Kyrgyz names. This update includes 7,500...


31.03.2025

Dictionary Update: Urdu Names

Our growing graph name database now includes around 10,100 terms in Urdu script along with their...


28.03.2025

Maintenance Notice

We would like to inform you that during the course of today, we will be performing scheduled...


24.02.2025

Version 10.7.0 Released

Release of Optimaize PII Platform, version 10.7.0.


20.01.2025

2024 Around the World

2024 has been a pivotal year for Optimaize, with notable advancements in our software capabilities,...


   

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
}