---
title: "Suggest Ipa"
method: POST
path: "/ipa/suggest"
---

# Suggest Ipa

`POST /ipa/suggest`

## Request

- Base URL: `https://api.neuphonic.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.neuphonic.com/ipa/suggest`
- Auth: none declared

How to say one word, in the sentence it appears in. `offset` picks the occurrence when
the word appears more than once; without `text` it is a plain dictionary lookup.

Every suggestion returned is already validated against the inventory, so it can go
straight into a `<phoneme:...>` tag. Anything out of domain is reported in `dropped`
rather than offered.

## Query parameters

- `api_key` string, nullable
- `jwt_token` string, nullable

## Headers

- `X-API-KEY` string, nullable
- `authorization` string, nullable

## Request body

- ApiRoutersIpaSuggestRequest: `text` is deliberately unbounded: send the whole script and let the server take the window. Capping it client-side is what broke this for anything longer than a paragraph.
  - `word` string, required
  - `text` string
  - `offset` integer, nullable
  - `key` string
  - `limit` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-23** `488903dca48b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/neuphonic/apis/neuphonic-api/changes/ipa/suggest/post.md)

---

[API](https://skmtc.dev/neuphonic/apis/neuphonic-api.md) - [All operations](https://skmtc.dev/neuphonic/apis/neuphonic-api/llms.txt) - [OpenAPI document](https://skmtc.dev/neuphonic/apis/neuphonic-api/revisions/941fd29844c9?raw)