Field Formats

• timezone — Decimal hours (number) or IANA string.
  Good: -5, 9.5, "America/New_York".
  Bad: "5:30", "GMT-5", "+0530".
• date — ISO date string.
  Good: "1990-01-15".
  Bad: "Jan 15 1990", "15/01/1990".
• time — 24-hour string with seconds.
  Good: "14:30:00", "09:00:00".
  Bad: "2:30 PM", "14:30".
• latitude / longitude — Decimal degrees (float).
  Good: 40.7128, -74.006.
  Bad: DMS strings, degree symbols.
• sign (Western horoscope path) — Lowercase zodiac.
  Good: aries, taurus, … pisces.
  Bad: "Aries", zodiac symbols.
• houseSystem — Kebab-case enum.
  Good: placidus (default), whole-sign, equal, koch.
  Bad: whole_sign, WholeSign.
• nodeType — Lowercase enum.
  Good: mean (default), true.
  Bad: "true-node", "True Node".

• timezone — Same as Western: decimal hours or IANA string.
• date — ISO date string.
• time — 24-hour string with seconds.
• latitude / longitude — Decimal degrees.
• ayanamsa (KP) — Kebab-case enum.
  Good: kp-newcomb (default), kp-old, lahiri, custom.
  Bad: "KP", "Lahiri".
• nodeType — Same as Western.

• fullName — Birth-certificate name.
  Good: "John William Smith".
  Bad: Nickname, married name.
• Numerology dates — Three separate integers.
  Good: year: 1990, month: 1, day: 15.
  Bad: A birthDate string.

• Tarot card id — Kebab-case slug, no leading article.
  Good: fool, star, ace-of-cups.
  Bad: Numeric like major-01.
• Tarot count — Integer 1 to 78.
  Good: 3, 10, 78.
  Bad: 0, 79, strings.
• seed (daily endpoints) — Any string.
  Good: "user-42", email hash.
  Bad: Numbers, objects.

• birthDate — ISO date string.
  Good: "1990-01-15".
  Bad: Date object, "15/01/1990".
• person1 / person2 — Nested object with full birth data { date, time, latitude, longitude, timezone }.
  Bad: Flat fields.

• Hexagram number — Integer 1 to 64.
  Good: 1, 64.
  Bad: "qian", names.

• sign — Lowercase zodiac.
  Good: aries, taurus.
  Bad: "Aries", symbols.
• chakra — Case-insensitive, punctuation-insensitive.
  Good: Heart, heart, Third Eye, third-eye.
  Bad: thirdEye, 3rd-eye.
• month (birthstone) — Integer 1-12.
  Good: 1, 12.
  Bad: "January", "01".

• number — String.
  Good: "1111", "777".
  Bad: 1111 (integer fails path validation).

No trailing slashes on any endpoint. Use /vedic-astrology/birth-chart, not /vedic-astrology/birth-chart/.

• /docs/coverage — Coverage and Scope
• /docs/agent-tasks — Agent Task Cheatsheet