Name Generation Service

The Wholesome Tools Name Generation Service is an open source GraphQL API for generating random names for use in fiction and test data. Names are combined from United States census and Social Security Administration data sets.

Note: This API is available for free without authentication. There may be some throttling to maintain affordability. For more demanding use cases, you can run your own version using our open source code base. Treat this resource as you would a public park, don’t litter! We provide no guarantees, warranties, or service level agreements whatsoever.

Fetch random names

Fetching a list of names is as sample as sending a POST request to the name service. Below is an example using curl

curl --data "{\"operationName\":null,\"variables\":{},\"query\":\"{\n  names {\n    given\n    surname\n    full\n  }\n}\n\"}" https://name-service.wholesometools.com/graphql

Here is a sample response from the service:

{
    "data":
    {
        "names":
        [
            {
                "given": "Armstead",
                "surname": "Moreno",
                "full": "Armstead Moreno"
            },
            {
                "given": "Austin",
                "surname": "Brady",
                "full": "Austin Brady"
            },
            {
                "given": "Minor",
                "surname": "Armstrong",
                "full": "Minor Armstrong"
            },
            {
                "given": "Norman",
                "surname": "Joseph",
                "full": "Norman Joseph"
            },
            {
                "given": "Press",
                "surname": "Adkins",
                "full": "Press Adkins"
            },
            {
                "given": "Edmund",
                "surname": "Turner",
                "full": "Edmund Turner"
            },
            {
                "given": "Lars",
                "surname": "Ross",
                "full": "Lars Ross"
            },
            {
                "given": "Paris",
                "surname": "Baker",
                "full": "Paris Baker"
            },
            {
                "given": "Marcellus",
                "surname": "Bell",
                "full": "Marcellus Bell"
            },
            {
                "given": "Perry",
                "surname": "Taylor",
                "full": "Perry Taylor"
            }
        ]
    }
}

API Sandbox

You can access the API’s GraphQL sandbox, including schema and generated docs below:

https://name-service.wholesometools.com/graphql

User interface

A public user interface to this API is available on the Wholesome Tools website:

https://www.wholesometools.com/names