Game Character Generator API

Overview

To use Game Character Generator, you need an API key. You can get one by creating a free account and visiting your dashboard.

GET Endpoint

https://api.apiverve.com/v1/gamecharacter

Example

How to call the Game Character Generator API in different programming languages.

curl -X GET \
  "https://api.apiverve.com/v1/gamecharacter?race=elf&class=mage" \
  -H "X-API-Key: your_api_key_here"

const response = await fetch('https://api.apiverve.com/v1/gamecharacter?race=elf&class=mage', {
  method: 'GET',
  headers: {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

import requests

headers = {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
}

response = requests.get('https://api.apiverve.com/v1/gamecharacter?race=elf&class=mage', headers=headers)

data = response.json()
print(data)

package main

import (
    "fmt"
    "io"
    "net/http"

)

func main() {
    req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/gamecharacter?race=elf&class=mage", nil)

    req.Header.Set("X-API-Key", "your_api_key_here")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

{
  "status": "ok",
  "error": null,
  "data": {
    "name": "Nimara Goldenbough",
    "race": {
      "name": "Elf",
      "traits": [
        "Graceful",
        "Keen Senses",
        "Long-lived"
      ]
    },
    "class": {
      "name": "Mage",
      "description": "Wielder of arcane magic",
      "primaryStat": "intelligence",
      "hitDie": "d6"
    },
    "background": "Criminal",
    "personality": "Ambitious and driven",
    "motivation": "Protect the innocent",
    "stats": {
      "strength": {
        "value": 13,
        "modifier": 1
      },
      "dexterity": {
        "value": 12,
        "modifier": 1
      },
      "constitution": {
        "value": 9,
        "modifier": -1
      },
      "intelligence": {
        "value": 11,
        "modifier": 0
      },
      "wisdom": {
        "value": 4,
        "modifier": -3
      },
      "charisma": {
        "value": 8,
        "modifier": -1
      }
    },
    "hp": 5,
    "totalStatPoints": 57,
    "highestStat": "strength",
    "lowestStat": "wisdom"
  }
}

Authentication

The Game Character Generator API requires authentication via API key. Include your API key in the request header:

X-API-Key: your_api_key_here

Learn more about authentication →

Interactive API Playground

Test the Game Character Generator API directly in your browser with live requests and responses.

Parameters

The following parameters are available for the Game Character Generator API:

Response

The Game Character Generator API returns responses in JSON, XML, YAML, and CSV formats. The JSON response is shown in the Example section above; alternative formats below.

Other Response Formats

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>ok</status>
  <error xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
  <data>
    <name>Nimara Goldenbough</name>
    <race>
      <name>Elf</name>
      <traits>
        <trait>Graceful</trait>
        <trait>Keen Senses</trait>
        <trait>Long-lived</trait>
      </traits>
    </race>
    <class>
      <name>Mage</name>
      <description>Wielder of arcane magic</description>
      <primaryStat>intelligence</primaryStat>
      <hitDie>d6</hitDie>
    </class>
    <background>Criminal</background>
    <personality>Ambitious and driven</personality>
    <motivation>Protect the innocent</motivation>
    <stats>
      <strength>
        <value>13</value>
        <modifier>1</modifier>
      </strength>
      <dexterity>
        <value>12</value>
        <modifier>1</modifier>
      </dexterity>
      <constitution>
        <value>9</value>
        <modifier>-1</modifier>
      </constitution>
      <intelligence>
        <value>11</value>
        <modifier>0</modifier>
      </intelligence>
      <wisdom>
        <value>4</value>
        <modifier>-3</modifier>
      </wisdom>
      <charisma>
        <value>8</value>
        <modifier>-1</modifier>
      </charisma>
    </stats>
    <hp>5</hp>
    <totalStatPoints>57</totalStatPoints>
    <highestStat>strength</highestStat>
    <lowestStat>wisdom</lowestStat>
  </data>
</response>

status: ok
error: null
data:
  name: Nimara Goldenbough
  race:
    name: Elf
    traits:
      - Graceful
      - Keen Senses
      - Long-lived
  class:
    name: Mage
    description: Wielder of arcane magic
    primaryStat: intelligence
    hitDie: d6
  background: Criminal
  personality: Ambitious and driven
  motivation: Protect the innocent
  stats:
    strength:
      value: 13
      modifier: 1
    dexterity:
      value: 12
      modifier: 1
    constitution:
      value: 9
      modifier: -1
    intelligence:
      value: 11
      modifier: 0
    wisdom:
      value: 4
      modifier: -3
    charisma:
      value: 8
      modifier: -1
  hp: 5
  totalStatPoints: 57
  highestStat: strength
  lowestStat: wisdom

Response Structure

All API responses follow a consistent structure with the following fields:

Learn more about response formats →

Response Data Fields

When the request is successful, the data object contains the following fields:

Headers

Only X-API-Key is required. Optional headers include Accept for response format negotiation (JSON, XML, or YAML), User-Agent, and X-Request-ID for request tracing. See all request headers →

GraphQL AccessALPHA

Access Game Character Generator through GraphQL to combine it with other API calls in a single request. Query only the game character generator data you need with precise field selection, and orchestrate complex data fetching workflows.

Credit Cost: Each API called in your GraphQL query consumes its standard credit cost.

POST https://api.apiverve.com/v1/graphql

query {
  gamecharacter(
    input: {
      race: "elf"
      class: "mage"
    }
  ) {
    name
    race {
      name
      traits
    }
    class {
      name
      description
      primaryStat
      hitDie
    }
    background
    personality
    motivation
    stats {
      strength {
        value
        modifier
      }
      dexterity {
        value
        modifier
      }
      constitution {
        value
        modifier
      }
      intelligence {
        value
        modifier
      }
      wisdom {
        value
        modifier
      }
      charisma {
        value
        modifier
      }
    }
    hp
    totalStatPoints
    highestStat
    lowestStat
  }
}

Note: Authentication is handled via the x-api-key header in your GraphQL request, not as a query parameter.

CORS Support

The Game Character Generator API accepts cross-origin requests from any origin, so it can be called directly from browser-based applications without a proxy. See CORS support →

Rate Limiting

Game Character Generator requests are throttled per minute on the Free plan and unthrottled on paid plans. Exceeding the limit returns 429 Too Many Requests; rate-limit usage is reported in the X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset response headers. See per-plan limits and best practices →

Error Codes

The Game Character Generator API uses standard HTTP status codes — 200 on success, 400 for invalid parameters, 401 for missing or invalid keys, 403 for insufficient credits, 429 for rate-limit exhaustion, and 500/503 for server-side issues. Each error response includes an X-Request-ID header you can quote when contacting support. See full error handling guide →

SDKs for Game Character Generator

Official Game Character Generator packages on npm, PyPI, NuGet, and JitPack — plus a Postman collection and an OpenAPI spec. See the SDK guide →

JitPack

No-Code Integrations

Game Character Generator works with Zapier, Make, Pipedream, n8n, and Power Automate using the same API key. See setup guides →

Zapier

Make

Pipedream

n8n

Power Automate

Frequently Asked Questions

People who used this also used...

Based on your interest in Game Character Generator, you might also like these APIs:

Word Search Generator

Word Search Generator creates customizable word search puzzles with configurable grid size, word placement, and difficulty levels.

1 credit per call

Word Scramble Generator

Word Scramble Generator creates puzzles where players unscramble letters to form words, with optional hints from dictionary definitions.

1 credit per call

Word Ladder Generator

Word Ladder Generator creates puzzles where players transform one word into another by changing one letter at a time, with each step forming a valid word.

1 credit per call