---
title: "Generate word lists tailored to specific phonemes with helpful hints"
method: POST
path: "/api/word-list-generator"
tags: ["AI Agents"]
---

# Generate word lists tailored to specific phonemes with helpful hints

`POST /api/word-list-generator`

## Request

- Base URL: `https://platform.vocametrix.com`
- URL: `https://platform.vocametrix.com/api/word-list-generator`
- Auth: API key in header `X-API-Key`

## Request body

- object
  - `language` string, required: Target language for words (english, french, spanish, german)
  - `age` integer, required: Patient age range (e.g., "3-6 years", "7-12 years", "adults")
  - `selectedSound` object, required: Object containing symbol (IPA phoneme) and position (beginning/middle/end/random)

## Response `200`

Successful response

- object
  - `words` string: String containing 20 words separated by semicolons
  - `hints` string: String containing 20 corresponding hints separated by semicolons
  - `wordHintPairs` object[]: Array of objects with word and hint properties

## Other responses

- `400`: Bad request — missing or invalid parameter
- `401`: Unauthorized — missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Server error

---

[API](https://skmtc.dev/vocametrix/apis/vocametrix-api.md) · [All operations](https://skmtc.dev/vocametrix/apis/vocametrix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vocametrix/apis/vocametrix-api/revisions/8a54d01bcc81?raw)