---
title: "Writes a monetary amount out in Turkish words, the way invoices, cheques and promissory notes require."
method: POST
path: "/v1/tr/money/to-words"
tags: ["Finance"]
---

# Writes a monetary amount out in Turkish words, the way invoices, cheques and promissory notes require.

`POST /v1/tr/money/to-words`

## Request

- Base URL: `https://api.temsor.com`
- URL: `https://api.temsor.com/v1/tr/money/to-words`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Applies the rules that trip up generic libraries: Turkish says "bin", never "bir bin"; the kuruş part is read separately; and both "1.234,56" and "1,234.56" are accepted and told apart automatically. A mandatory field on Turkish e-invoices, cheques and notes — with no off-the-shelf API until now.

**Credits per call:** 1 · **Operation id:** `tr_money_to_words`

## Request body

- object
  - `amount` union, required: Amount. Accepts both "1.234,56" and 1234.56.
    - string
    - number
  - `currency` 'TRY' | 'USD' | 'EUR' | 'GBP'
  - `style` 'lower' | 'title' | 'upper': Output letter case.
  - `wrapHash` boolean

## Response `200`

Success

- object
  - `ok` unknown, required
  - `data` object, required
    - `amount` object, required
      - `major` string, required
      - `minor` number, required
      - `negative` boolean, required
    - `currency` string, required
    - `words` string, required
    - `formatted` string, required
  - `meta` object
    - `credits` integer
    - `cached` boolean
    - `requestId` string
    - `durationMs` integer

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `429`: Rate limit exceeded — wait `Retry-After` seconds. The RateLimit headers are sent here too.

---

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