---
title: "List the account's protected terms"
method: GET
path: "/v1/terms"
tags: ["Account Terms"]
---

# List the account's protected terms

`GET /v1/terms`

## Request

- Base URL: `https://hc.itsbaba.com`
- URL: `https://hc.itsbaba.com/v1/terms`
- Auth: HTTP bearer

Every account term, sorted by term, with the account limit. Account terms are names that must never change in translation (drug, product and brand names). Every protected translation on the account keeps them exactly as written, or uses `translations[target]` when it is set: /v1/translate, /v1/translate/batch and the Clinical API. They are applied by placeholder masking, so the model never sees them and cannot alter them, and they switch protection on automatically for Hebrew, English and Russian pairs.

**Quota.** Does not consume the character quota.

## Response `200`

Terms

- AccountTermList
  - `terms` AccountTerm[], required
    - `id` string, required
    - `term` string, required: Kept exactly as written in every protected translation.
    - `translations` object, required: Optional required rendering per target language. When set for the target, it replaces the term; otherwise the term is kept verbatim.
      - `he` string
      - `en` string
      - `ru` string
    - `note` string, nullable, required: Your own note, up to 500 characters.
    - `created_at` string, required: ISO 8601 timestamp.
  - `limit` integer, required

## Other responses

- `400`: Invalid body, a term that is empty or too long, an unsupported language in `translations`, or the account limit reached.
- `401`: Missing, malformed, invalid or revoked API key.
- `402`: A new self-serve account must save a card in the console before it can use the API. Adding a card is free.
- `403`: The connection used TLS older than 1.2.
- `429`: Too many requests this minute. Retry after a short wait.
- `500`: Unexpected server error. Safe to retry.

---

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