Western product UX¶
Product UX endpoints aggregate deterministic Western calculations into frontend-ready cards. They do not generate interpretation prose and do not replace the lower-level calculation endpoints; they are convenience payloads for app screens.
Card shape¶
{
"id": "profile_communication",
"title": "communication",
"subtitle": "verbal_connector",
"score": 0.76,
"kind": "profile_summary",
"signals": [
{"key": "mercury", "label": "Mercury strength", "value": 0.82}
]
}
Profile summary cards — GET /v1/western/charts/{id}/ux/profile-summary-cards¶
Required scope: charts:read
Returns one card per product profile domain.
Daily personal weather — GET /v1/western/charts/{id}/ux/daily-personal-weather¶
Required scope: charts:read
| Query param | Type | Required |
|---|---|---|
day |
date, YYYY-MM-DD |
yes |
The response combines annual profection, progressed lunation, and the strongest same-day transit windows.
Next important transit — GET /v1/western/charts/{id}/ux/next-important-transit¶
Required scope: charts:read
| Query param | Type | Required |
|---|---|---|
starts_at |
ISO 8601 datetime | yes |
ends_at |
ISO 8601 datetime | no, defaults to 90 days after starts_at |
Returns the highest-strength transit card in the requested window. Windows are limited to 400 days.
Timeline cards — GET /v1/western/charts/{id}/ux/timeline-cards¶
Required scope: charts:read
| Query param | Type | Required |
|---|---|---|
starts_at |
ISO 8601 datetime | yes |
ends_at |
ISO 8601 datetime | yes |
Returns up to eight cards from the strongest transit windows.
Relationship highlights — POST /v1/western/ux/relationship-highlights¶
Required scope: compatibility:read
Returns key relationship contact cards plus ranked compatibility topics.
Best compatibility topics — POST /v1/western/ux/best-compatibility-topics¶
Required scope: compatibility:read
Uses the same request and response shape as relationship highlights. The
topics[] array is ranked by score and is intended for tab labels,
comparison chips, or onboarding screens.