Rand Name API Documentation:

Endpoint

• URL: https://www.cjglitter.com/rand_name/api

Request Method

• HTTP Method: GET

Query Parameters

1. last_name

   Type: Boolean

   Description: If set to true, the API will generate names that include a last name.

2. middle_name

   Type: Boolean

   Description: If set to true, the API will generate names that include a middle name. By nature, this also ensures that the responses have last names as well.

3. count

   Type: Integer

   Description: Specifies the number of responses to be generated.

   Limits: The value should be an integer between 1 and 20 (inclusive).

Example Request

Example Response

{
  "results": [
    {
      "name": {
        "title": null,
        "first_name": "Perrin",
        "middle_name": "t'Bashere",
        "last_name": "Aybara"
      }
    },
    {
      "name": {
        "title": null,
        "first_name": "Jalanda",
        "middle_name": "son of Aried son of",
        "last_name": "Coiam"
      }
    },
    {
      "name": {
        "title": null,
        "first_name": "Bringer",
        "middle_name": "of",
        "last_name": "Gales"
      }
    },
    {
      "name": {
        "title": null,
        "first_name": "Caar",
        "middle_name": "al Thorin al",
        "last_name": "Toren"
      }
    },
    {
      "name": {
        "title": null,
        "first_name": "Mara",
        "middle_name": "Tomanes",
        "last_name": "(2)"
      }
    }
  ]
}

Response Format

• results: An array containing objects representing generated names.
  • name:
    • title: The generated title (null if not applicable).
    • first_name: The generated first name.
    • middle_name: The generated middle name (null if not applicable).
    • last_name: The generated last name (null if not applicable).

Error Responses

• HTTP Status Code: 404 Not Found

  Content: {"error": "Endpoint not found. Please check the URL."}

• HTTP Status Code: 400 Bad Request

  Content: {"error": "Invalid query parameters. Please check the documentation."}

• HTTP Status Code: 422 Unprocessable Entity

  Content: {"errors": [{"status": 422, "title": "Invalid count", "detail": "Request must be between 1–20 results."}]}