Field Formats (agent gotchas)

Name: RoxyAPI
Rating: 4.5 (127 reviews)

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	`"1990-01-15"`	`"Jan 15 1990"`, `"15/01/1990"`
`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

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	`"1990-01-15"`	`"Jan 15 1990"`, `"15/01/1990"`
`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

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

Field	Format	Good	Bad
Tarot card `id`	Kebab-case slug	`the-fool`, `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

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

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

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

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

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

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