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

News

15.05.2026

Identifying Titles in Global Name Data

We have updated our NameAPI database with titles from more than 80 cultures. Our services identify...


20.04.2026

Database Update: Georgian Names Added

We are pleased to announce the latest expansion of our name database with a comprehensive...


26.02.2026

Enhanced NameAPI Database

We are excited to announce a major update to the NameAPI database, reflecting the extensive...


11.02.2026

Software Version 11.2.0 Deployed

NameMatcher: More resilient matching for real-world names

Previously, if an input could not be...


05.01.2026

2025 Around the World

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


   

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
}