# Natal texts (static)

`GET https://api.astroway.info/v1/natal-texts`

Edited interpretation texts for a chart, no AI at request time. `keys` is a comma list of up to 64: `sun.aries` (planet in sign, also `chiron`, `ascendant`), `moon.h4` (planet in house), `sun_moon.trine` (major aspect between two of Sun..Pluto). `lang` is required; a text that does not exist in that language is listed in `missing`, never replaced by another language. Planet in sign covers 20 languages; houses and aspects are being written. Plain text, paragraphs separated by a blank line.

Group: Reference. Auth: `X-Api-Key` header. Operation ID: `natal-texts_get`.

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `keys` | query | yes | string | Comma list of up to 64 distinct keys: `<body>.<sign>` (planet in sign, also `chiron`, `ascendant`), `<body>.h<1-12>` (planet in house), `<body>_<body>.<aspect>` (conjunction, sextile, square, trine, opposition between two of Sun..Pluto). |
| `lang` | query | yes | "uk" \| "en" \| "de" \| "pl" \| "es" \| "pt" \| "fr" \| "it" \| … | Language of the texts. No fallback: a text missing in this language is listed in `missing`. |
| `fields` | query | no | string | Comma-separated dotted paths, relative to `data`, to keep in the response. A path is applied to every element of an array, so `planets.name` means the name of each planet. Paths that match nothing come back in `_fields_unmatched`; a list where nothing matches at all is a 400, because an empty object would be a confident wrong answer. |
| `precision` | query | no | integer | Round every non-integer number in the response to this many decimal places. Integers are left alone, because an id is not a measurement. Ecliptic longitudes ship with fourteen decimals by default; 2 is about a tenth of an arcminute. |

## Responses

| Status | Meaning |
|---|---|
| 200 | Successful calculation |
| 400 | Validation error |
| 401 | Missing or invalid API key |

### Success fields, under `data`

| Field | Type | Required | Description |
|---|---|---|---|
| `lang` | string | no |  |
| `texts` | object | no |  |
| `texts.sun.aries` | object | no |  |
| `missing` | string[] | no |  |

## Example

```bash
curl -X GET https://api.astroway.info/v1/natal-texts?keys=sun.aries,moon.h4,sun_moon.trine&lang=en \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json"
```

---

Rendered from https://api.astroway.info/v1/openapi.json. HTML page: https://api.astroway.info/docs/api/operations/natal-texts_get/
