Input schema (JSON)
{
"type": "object",
"examples": [
{
"person1": {
"date": "1990-07-15",
"time": "14:30:00",
"latitude": 40.7128,
"timezone": "America/New_York",
"longitude": -74.006
},
"person2": {
"date": "1990-07-15",
"time": "14:30:00",
"latitude": 40.7128,
"timezone": "America/New_York",
"longitude": -74.006
}
}
],
"required": [
"person1",
"person2"
],
"properties": {
"lang": {
"enum": [
"en",
"tr",
"de",
"es",
"hi",
"pt",
"fr",
"ru",
"zh-Hans",
"zh-Hant"
],
"type": "string",
"default": "en",
"example": "en",
"description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
},
"compact": {
"type": "boolean",
"default": false,
"description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
},
"person1": {
"type": "object",
"required": [
"date",
"time",
"latitude",
"longitude",
"timezone"
],
"properties": {
"date": {
"type": "string",
"format": "date",
"example": "1990-07-15",
"description": "Birth date in YYYY-MM-DD format. Determines planetary positions for the specific calendar day."
},
"time": {
"type": "string",
"format": "time",
"example": "14:30:00",
"description": "Birth time in 24-hour HH:MM:SS format. Determines the Ascendant (rising sign) and house cusps. Use 12:00:00 if unknown."
},
"latitude": {
"type": "number",
"example": 40.7128,
"maximum": 90,
"minimum": -90,
"description": "Birth location latitude in decimal degrees (-90 to 90). Positive = North, negative = South."
},
"nodeType": {
"enum": [
"mean",
"true"
],
"type": "string",
"default": "true",
"example": "true",
"description": "Lunar node convention. \"mean\" is the smoothed average node, which always moves retrograde; \"true\" is the osculating node, which tracks the real perturbed node, oscillates up to about 1.5 degrees either side of the mean on a 173-day cycle, and can briefly turn direct. Neither is more correct and they almost always fall in the same sign. Applies to the North and South Node. True is the osculating node and the default, because it is what most Western chart software reports; mean is the smoothed node preferred by several evolutionary schools, so pass \"mean\" to match one. Nothing else in the chart changes, and the two agree on the sign except when the node sits within about 1.8 degrees of a cusp. Defaults to \"true\"."
},
"timezone": {
"anyOf": [
{
"type": "number",
"maximum": 14,
"minimum": -14
},
{
"type": "string"
}
],
"example": "America/New_York",
"description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time."
},
"longitude": {
"type": "number",
"example": -74.006,
"maximum": 180,
"minimum": -180,
"description": "Birth location longitude in decimal degrees (-180 to 180). Positive = East, negative = West."
}
},
"description": "First person birth details (date, time, location, timezone)."
},
"person2": {
"type": "object",
"required": [
"date",
"time",
"latitude",
"longitude",
"timezone"
],
"properties": {
"date": {
"type": "string",
"format": "date",
"example": "1990-07-15",
"description": "Birth date in YYYY-MM-DD format. Determines planetary positions for the specific calendar day."
},
"time": {
"type": "string",
"format": "time",
"example": "14:30:00",
"description": "Birth time in 24-hour HH:MM:SS format. Determines the Ascendant (rising sign) and house cusps. Use 12:00:00 if unknown."
},
"latitude": {
"type": "number",
"example": 40.7128,
"maximum": 90,
"minimum": -90,
"description": "Birth location latitude in decimal degrees (-90 to 90). Positive = North, negative = South."
},
"nodeType": {
"enum": [
"mean",
"true"
],
"type": "string",
"default": "true",
"example": "true",
"description": "Lunar node convention. \"mean\" is the smoothed average node, which always moves retrograde; \"true\" is the osculating node, which tracks the real perturbed node, oscillates up to about 1.5 degrees either side of the mean on a 173-day cycle, and can briefly turn direct. Neither is more correct and they almost always fall in the same sign. Applies to the North and South Node. True is the osculating node and the default, because it is what most Western chart software reports; mean is the smoothed node preferred by several evolutionary schools, so pass \"mean\" to match one. Nothing else in the chart changes, and the two agree on the sign except when the node sits within about 1.8 degrees of a cusp. Defaults to \"true\"."
},
"timezone": {
"anyOf": [
{
"type": "number",
"maximum": 14,
"minimum": -14
},
{
"type": "string"
}
],
"example": "America/New_York",
"description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time."
},
"longitude": {
"type": "number",
"example": -74.006,
"maximum": 180,
"minimum": -180,
"description": "Birth location longitude in decimal degrees (-180 to 180). Positive = East, negative = West."
}
},
"description": "Second person birth details (date, time, location, timezone)."
},
"houseSystem": {
"enum": [
"placidus",
"whole-sign",
"equal",
"koch"
],
"type": "string",
"default": "placidus",
"example": "placidus",
"description": "House system for the composite chart. Placidus (default), Whole Sign, Equal, or Koch."
}
}
}