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

News

18.11.2024

Dictionary Update: Ukrainian Names

A member of the East Slavic family, the Ukrainian language shares deep historical roots with...


04.11.2024

New Python Client Library Released

We have implemented a Python client library, now available on PyPI, providing easy access to...


22.10.2024

Software Version 10.6.0 Released

This update brings several improvements and new features designed to enhance the accuracy and...


11.10.2024

Discovering Czech Names

As part of the West Slavic group, the Czech language shares similarities with Slovak and Polish,...


25.09.2024

Romanian Names Added

The Romanian language, a Romance language derived from Latin, is unique in Eastern Europe,...


   

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
}