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

News

25.07.2024

Database Update: An Extensive Collection of Croatian Names Available

Naming conventions in Croatia emphasize family heritage, often involving naming children after...


16.07.2024

Albanian Names in Focus

Did you know that Albanian names reflect a blend of ancient Illyrian heritage, religious influences...


25.06.2024

Swedish names: Tracing the Threads of Northern Culture

Originating from Old Norse, Swedish is spoken in Sweden and in regions of Finland, where it enjoys...


07.06.2024

Expanded NameAPI Database for Company Legal Forms

We've expanded our NameAPI database to include a comprehensive list of company legal forms from...


27.05.2024

Software Version 10.3.0 Deployed

We are pleased to announce the deployment of Software Version 10.3.0, bringing significant...


   

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
}