# नाटल चार्ट के पाठ

`GET /v1/natal-texts` returns ready-made interpretation texts for chart positions. The texts are written and edited in advance, nothing is generated on request.

## Request

```http
GET /v1/natal-texts?keys=sun.aries,moon.h4,sun_moon.trine&lang=uk HTTP/1.1
X-Api-Key: aw_live_...
```

- `keys`: up to 64 different keys separated by commas.
  - planet in sign: `sun.aries`, also `chiron.leo`, `ascendant.virgo`;
  - planet in house: `moon.h4`;
  - aspect between two from Sun..Pluto: `sun_moon.trine` (conjunction, sextile, square, trine, opposition). The order of the pair doesn't matter, `moon_sun` will become `sun_moon`.
- `lang`: required, one of the 20 site languages.

## Response

```json
{
  "lang": "uk",
  "texts": {
    "sun.aries": { "title": "Сонце в Овні", "body": "…", "kind": "planet_in_sign" }
  },
  "missing": ["moon.h4", "sun_moon.trine"]
}
```

Text that doesn't exist in the requested language goes into `missing`. We don't substitute another language. `body` is plain text, paragraphs separated by empty lines.

## What's Already Available

Planet in sign: 144 texts in twenty languages. Planet in house and aspects are being written and will appear in this same endpoint.

## Price and Cache

`/v1/natal-texts` costs as one regular call (10 credits), no matter how many keys. Responses with keys are not cached on CDN (`Cache-Control: no-store`), so save the texts yourself by key and language: the text only changes after editing.