Skip to content

Set up your AI agent Get started API Reference SDK Remote MCP Free Templates

Astrology API field formats for dates and timezones

Fields LLMs most often get wrong. Copy the format exactly.

Western Astrology

Field	Format	Good	Bad
`timezone`	Decimal hours (number) OR IANA string	`-5` (NY EST), `9.5` (Adelaide ACST), OR `"America/New_York"`	`"5:30"`, `"GMT-5"`, `"+0530"`
`date`	ISO date string, 1550-01-02 to 2650-01-22	`"1990-01-15"`	`"Jan 15 1990"`, `"15/01/1990"`, `"1400-01-01"` (400 `date_out_of_range`)
`time`	24-hour string with seconds	`"14:30:00"`, `"09:00:00"`	`"2:30 PM"`, `"14:30"`
`latitude` / `longitude`	Decimal degrees (float)	`40.7128`, `-74.006`	DMS strings, degree symbols
`sign` (Western horoscope path)	Lowercase zodiac	`aries`, `taurus`, ... `pisces`	`"Aries"`, zodiac symbols, numbers
`houseSystem`	Kebab-case enum	`placidus` (default), `whole-sign`, `equal`, `koch`	`whole_sign`, `WholeSign`
`nodeType`	Lowercase enum	`mean` (default), `true`	`"true-node"`, `"mean-node"`, `"True Node"`
`person1` / `person2`	Nested object with full birth data	`{ date, time, latitude, longitude, timezone }`	Flat fields
`seed` (daily endpoints)	Any string	`"user-42"`, email hash	Numbers, objects

Vedic Astrology

Field	Format	Good	Bad
`timezone`	Decimal hours (number) OR IANA string	`-5` (NY EST), `9.5` (Adelaide ACST), OR `"America/New_York"`	`"5:30"`, `"GMT-5"`, `"+0530"`
`date`	ISO date string, 1550-01-02 to 2650-01-22	`"1990-01-15"`	`"Jan 15 1990"`, `"15/01/1990"`, `"1400-01-01"` (400 `date_out_of_range`)
`time`	24-hour string with seconds	`"14:30:00"`, `"09:00:00"`	`"2:30 PM"`, `"14:30"`
`latitude` / `longitude`	Decimal degrees (float)	`40.7128`, `-74.006`	DMS strings, degree symbols
`ayanamsa` (KP)	Kebab-case enum	`kp-newcomb` (default), `kp-old`, `lahiri`, `custom`	`"KP"`, `"Lahiri"`
`nodeType`	Lowercase enum	`mean` (default), `true`	`"true-node"`, `"mean-node"`, `"True Node"`
`person1` / `person2`	Nested object with full birth data	`{ date, time, latitude, longitude, timezone }`	Flat fields
`seed` (daily endpoints)	Any string	`"user-42"`, email hash	Numbers, objects

Numerology

Field	Format	Good	Bad
`fullName` (numerology)	Birth-certificate name	`"John William Smith"`	Nickname, married name
Numerology `{ year, month, day }`	Three separate integers	`year: 1990, month: 1, day: 15`	A `birthDate` string

Tarot

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

Biorhythm

Field	Format	Good	Bad
`birthDate` (biorhythm)	ISO date string	`"1990-01-15"`	Date object, `"15/01/1990"`
`date`	ISO date string	`"1990-01-15"`	`"Jan 15 1990"`, `"15/01/1990"`
`seed` (daily endpoints)	Any string	`"user-42"`, email hash	Numbers, objects
`person1` / `person2`	Nested object with full birth data	`{ date, time, latitude, longitude, timezone }`	Flat fields

I-Ching

Field	Format	Good	Bad
I Ching hexagram `number`	Integer 1 to 64	`1`, `64`	`"qian"`, names
`seed` (daily endpoints)	Any string	`"user-42"`, email hash	Numbers, objects

Crystals

Field	Format	Good	Bad
`sign` (Western horoscope path)	Lowercase zodiac	`aries`, `taurus`, ... `pisces`	`"Aries"`, zodiac symbols, numbers
`chakra`	Case-insensitive, punctuation-insensitive	`Heart`, `heart`, `Third Eye`, `third-eye`, `third_eye`, `Third%20Eye`, `Solar Plexus`, `solar-plexus`, `Crown`, `Root`, `Sacral`, `Throat`	`thirdEye`, `3rd-eye`
`month` (birthstone)	Integer 1-12	`1`, `12`	`"January"`, `"01"`

Dreams

Field	Format	Good	Bad
Dream symbol `id`	Kebab-case slug	`flying`, `losing-teeth`, `water`	Display names with spaces

Angel Numbers

Field	Format	Good	Bad
`number` (angel number path)	String	`"1111"`, `"777"`	`1111` (integer fails path validation)

Path Hygiene

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