---
title: "Calculate Simple Natal"
method: POST
path: "/natal"
tags: ["Simple Natal", "Simple Natal"]
---

# Calculate Simple Natal

`POST /natal`

## Request

- Base URL: `https://api.freeastroapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.freeastroapi.com/natal`
- Auth: none declared

A simplified natal endpoint for developer-facing apps.
Returns a compact response with curated planets, houses, and useful summary fields.

## Request body

- union
  - object
    - `name` string, nullable
    - `year` integer, required
    - `month` integer, required
    - `day` integer, required
    - `hour` integer, nullable
    - `minute` integer, nullable
    - `time_known` boolean
    - `city` string, nullable, required
    - `lat` number, nullable
    - `lng` number, nullable
    - `tz_str` string, nullable
  - object
    - `name` string, nullable
    - `year` integer, required
    - `month` integer, required
    - `day` integer, required
    - `hour` integer, nullable
    - `minute` integer, nullable
    - `time_known` boolean
    - `city` string, nullable
    - `lat` number, nullable, required
    - `lng` number, nullable, required
    - `tz_str` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/freeastroapi/apis/astroservice-api.md) · [All operations](https://skmtc.dev/freeastroapi/apis/astroservice-api/llms.txt) · [OpenAPI document](https://skmtc.dev/freeastroapi/apis/astroservice-api/revisions/0c9b4a759522?raw)
