# Dating & Compatibility API — compatibility in one call

For dating apps: `POST /v1/match/score` returns **everything you need in one call** — instead of making synastry + attraction + your own flag logic separately. On top of it sits the full compatibility suite (synastry, Vedic Ashtakoot, composite/Davison, AI narrative).

## `/match/score` — the dating aggregate

Same `chart1` + `chart2` input as `/synastry`. One call — Tier 3.

```bash
curl -X POST https://api.astroway.info/v1/match/score \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "chart1": { "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 2, "latitude": 50.45, "longitude": 30.52 },
        "chart2": { "date": "1988-03-20", "time": "09:00:00", "timezoneOffset": -5, "latitude": 40.71, "longitude": -74.0 } }'
```

Returns:
- `score` (0-100) + `label` (`challenging` / `mixed` / `balanced` / `harmonious`) + `harmony` / `tension`
- `attraction` — a separate score (Venus-Mars / Moon-Venus / 5th-house)
- `topAspects` — the most influential cross-aspects with a `tone`
- `greenFlags` / `redFlags` — harmonious personal aspects vs hard aspects to Mars/Saturn/Uranus/Pluto

<Aside type="note">
The flags and score are a re-shape of the **same** GREEN synastry engine (`calcCompatibilityScore` + `calcAttractionScore`); no invented scoring model. Numbers are identical to `/synastry` + `/synastry/attraction-score`.
</Aside>

## The full compatibility suite

| Need | Endpoint |
|---|---|
| Full synastry (all cross-aspects) | `POST /v1/synastry` |
| Aspect grid / house overlay / element balance | `POST /v1/synastry/{aspect-grid,house-overlay,element-balance}` |
| AI compatibility narrative ("why you match") | `POST /v1/interpret/synastry` |
| Vedic compatibility (Ashtakoot 36-point, for India) | `POST /v1/vedic/compatibility/{ashtakoot,full,manglik-check}` |
| Long-term outlook (midpoint chart) | `POST /v1/composite`, `POST /v1/davison` |

## Pricing

`/match/score` is **Tier 3**. The other compatibility endpoints follow the [credit tiers](/en/rate-limits-credits/). There is no separate delivery charge.