# Legal & Contracts

Part of the HebrewCore documentation. Web: https://hc.itsbaba.com/docs#solution-legal · Whole docs: https://hc.itsbaba.com/docs.md · Index: https://hc.itsbaba.com/llms.txt

Contracts, terms of service, privacy policies and formal notices, where "shall" and "may" are not the same word and Section 4.2 must still point to Section 4.2.

## What to Use

| Need | Use |
| --- | --- |
| Legal protection and register | `domain: "legal"`, described in [Domains](https://hc.itsbaba.com/docs#domains). |
| Party names | `protected_terms`, or `redact_terms` for private individuals. |
| Fixed renderings of defined terms | `glossary`, for example `"Effective Date": "המועד הקובע"`. |
| Long documents | One clause per item in `/v1/translate/batch`, at `quality: "smartest"`. |

## Example

```http
POST /v1/translate
{
  "text": "The Supplier shall not assign this Agreement without the prior written consent of Northwind Ltd. (the \"Customer\"). The Customer may terminate this Agreement on 30 days' notice.",
  "source_lang": "en",
  "target_lang": "he",
  "domain": "legal",
  "protected_terms": ["Northwind Ltd."],
  "quality": "smartest"
}

{
  "translation": {
    "text": "הספק לא יסב הסכם זה ללא הסכמה מראש ובכתב של Northwind Ltd. (להלן: ״הלקוח״). הלקוח רשאי לסיים הסכם זה בהודעה מוקדמת של 30 יום.",
    "dir": "rtl",
    "protection": {
      "status": "ok",
      "spans": [
        { "type": "term", "value": "Northwind Ltd." },
        { "type": "defined_term", "value": "Customer", "render": "הלקוח" },
        { "type": "number", "value": "30" }
      ],
      "issues": [],
      …
    }
  }
}
```

## Pitfalls

- **Defined terms are translated.** "the Customer" becomes (להלן: ״הלקוח״) once and הלקוח after that. Pin a specific rendering with `glossary`; put a party's legal name in `protected_terms` to keep it as written.
- **Modality.** If "shall not" comes back as "may not", or "may" as "shall", the sentence falls back. Review fallback clauses by hand.
- **Size.** A single request carries up to 20,000 characters. Split a long contract by clause, which also keeps retries small.
- **Binding text.** A translation is a reading aid. State which language governs, and keep the original with it.