Skip to main content
POST
Parse a list of names

Authorizations

Authorization
string
header
required

Workspace API key (loice_sk_ + 48 hex characters), created under Settings → API Keys. Sent as Authorization: Bearer loice_sk_…. Invalid, missing, or expired keys are rejected with 401 before any billable work happens.

Headers

Idempotency-Key
string
required

REQUIRED, 1–255 printable ASCII characters, scoped to your workspace. Each answered row is its own billed operation under this key and the row’s position, so retrying the same batch with the same key replays every answered row for free. The same key with a different batch (any change to names or spelling) is refused whole with 409 idempotency_conflict before any row runs. The key is stored as sent: never put a name or other personal data in it.

Required string length: 1 - 255

Body

application/json
names
string[]
required

1 to 100 names, each answered in order. A non-string element refuses the whole request; a blank name or one longer than 256 characters is that row’s validation_error.

Required array length: 1 - 100 elements
spelling
enum<string>

as-written (default) returns the words as you sent them, cleaned of honorifics, credentials and asides. folded returns the key spelling: lower case, diacritics removed (José Núñez → jose / nunez).

Available options:
as-written,
folded

Response

One result per submitted name, in input order. pointsCharged is the sum of the rows; replay is true when every answered row replayed an earlier call with this key.

data
object
required