---
title: "14 Main Stars"
method: POST
path: "/ziwei/main-stars"
tags: ["Zi Wei Dou Shu (Purple Star): MVP"]
---

# 14 Main Stars

`POST /ziwei/main-stars`

The 14 main stars in canonical order (Zi Wei series, then Tian Fu series) with theme/archetype. Reference table: does not vary with the date.

## Request body

- ZiweiDateInput
  - `date` string, required
  - `time` string
  - `timezoneOffset` number

## Response `200`

Successful calculation

- object
  - `ok` boolean
  - `data` object
    - `fourteenMainStars` object[], nullable
      - `name` string, nullable
      - `pinyin` string, nullable
      - `chinese` string, nullable
      - `series` string, nullable
      - `theme` string, nullable

## Other responses

- `400` — Validation error
- `401` — Missing or invalid API key

---

[API](https://skmtc.net/astroway/apis/astroway-calculation-api.md) · [All operations](https://skmtc.net/astroway/apis/astroway-calculation-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/astroway/astroway-calculation-api/revisions/6828e5609564/schema)