POST/v1/western/composite

Western Composite Chart

Midpoint composite chart for two people using modern Western midpoint technique. Each composite planet is the midpoint of the two natal positions. Returns composite planets with dignities and internal aspects.

Request parameters

person1required

object

person1.locationoptional

string | null

City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.

person1.nameoptional

string

Person name associated with the birth record

person1.daterequired

string

Birth date in YYYY-MM-DD format

person1.timeoptional

string | null

Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.

person1.latitudeoptional

number | null

Latitude. Required if location not provided.

person1.longitudeoptional

number | null

Longitude. Required if location not provided.

person1.timezoneoptional

string | null

IANA timezone. Required if location not provided.

person1.ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

person2required

object

person2.locationoptional

string | null

City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.

person2.nameoptional

string

Person name associated with the birth record

person2.daterequired

string

Birth date in YYYY-MM-DD format

person2.timeoptional

string | null

Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.

person2.latitudeoptional

number | null

Latitude. Required if location not provided.

person2.longitudeoptional

number | null

Longitude. Required if location not provided.

person2.timezoneoptional

string | null

IANA timezone. Required if location not provided.

person2.ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.planets

array[object]

data.planets[].name

string

data.planets[].longitude

number

data.planets[].sign

string

data.planets[].sign_index

integer

data.planets[].degree_in_sign

number

data.planets[].dignity

string

data.planets[].dignity_score

integer

data.ascendant_longitude

number

data.ascendant_sign

string

data.ascendant_sign_index

integer

data.aspects

array[object]

data.aspects[].person1_planet

string

data.aspects[].person2_planet

string

data.aspects[].type

string

data.aspects[].exact_angle

number

data.aspects[].orb

number

Errors

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

API key tier does not include this endpoint.

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

Related endpoints

• Western Compatibility Score
• Western Synastry
• Western Zodiac Sign Compatibility

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/western/composite" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"person1":{"name":"Arjun Mehta","date":"1985-11-12","time":"06:45","latitude":19.076,"longitude":72.8777,"timezone":"Asia/Kolkata"},"person2":{"name":"Sofia Shah","date":"1988-03-24","time":"14:30","latitude":28.6139,"longitude":77.209,"timezone":"Asia/Kolkata"}}'

Python

import asterwise
from asterwise.api.western_astrology_api import WesternAstrologyApi
from asterwise.models.two_person_request import TwoPersonRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = TwoPersonRequest(
    person1={'name': 'Arjun Mehta', 'date': '1985-11-12', 'time': '06:45', 'latitude': 19.076, 'longitude': 72.8777, 'timezone': 'Asia/Kolkata'},
    person2={'name': 'Sofia Shah', 'date': '1988-03-24', 'time': '14:30', 'latitude': 28.6139, 'longitude': 77.209, 'timezone': 'Asia/Kolkata'},
)

with asterwise.ApiClient(configuration) as client:
    api = WesternAstrologyApi(client)
    result = api.western_composite(two_person_request=request)
    print(result)

TypeScript

import { createClient, createConfig, westernComposite } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await westernComposite({
  client,
  body: {
      "person1": {
        "name": "Arjun Mehta",
        "date": "1985-11-12",
        "time": "06:45",
        "latitude": 19.076,
        "longitude": 72.8777,
        "timezone": "Asia/Kolkata"
      },
      "person2": {
        "name": "Sofia Shah",
        "date": "1988-03-24",
        "time": "14:30",
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata"
      }
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "planets": [
      {
        "name": "Sun",
        "longitude": 296.770075,
        "sign": "Capricorn",
        "sign_index": 9,
        "degree_in_sign": 26.770075,
        "dignity": "peregrine",
        "dignity_score": 0
      },
      {
        "name": "Moon",
        "longitude": 153.200022,
        "sign": "Virgo",
        "sign_index": 5,
        "degree_in_sign": 3.200022,
        "dignity": "peregrine",
        "dignity_score": 0
      },
      "... and 8 more items"
    ],
    "ascendant_longitude": 180.27487,
    "ascendant_sign": "Libra",
    "ascendant_sign_index": 6,
    "aspects": [
      {
        "person1_planet": "Jupiter",
        "person2_planet": "Uranus",
        "type": "square",
        "exact_angle": 87.757,
        "orb": 2.243
      },
      {
        "person1_planet": "Mars",
        "person2_planet": "Moon",
        "type": "square",
        "exact_angle": 87.0676,
        "orb": 2.9324
      },
      "... and 6 more items"
    ]
  }
}