Skip to content
96Astro API
Get API Key

AI interpretation

Available

AI Chat for a Couple API

An AI answer about two people, with earlier turns as history; grounded in their computed matching report.

  • POST /v1/ai/ai-match-chat
  • Metered, from 15 credits
Get a free key API reference
Request
curl https://api.96astroapi.com/v1/ai/ai-match-chat \  -H "Authorization: Bearer $ASTRO_API_KEY" \  -H "Content-Type: application/json" \  -d '{
      "groom": {
        "datetime": "1990-10-18T14:30:00",
        "timezone": "Asia/Kolkata",
        "latitude": 28.6139,
        "longitude": 77.209
      },
      "bride": {
        "datetime": "1992-03-05T09:15:00",
        "timezone": "Asia/Kolkata",
        "latitude": 28.6139,
        "longitude": 77.209
      },
      "tier": "fast",
      "question": "What should we watch out for in our first years together?"
    }'

Overview

An AI answer about two people, with earlier turns as history; grounded in their computed matching report.

Call it with POST /v1/ai/ai-match-chat. Input: two people's birth details. Output: JSON, as a direct response. Each successful call costs metered, from 15 credits.

  • POST /v1/ai/ai-match-chat
  • Metered, from 15 credits
  • Two people's birth details

Example response

Fields in dataThe response contract: required fields are always present.

  • modestring
  • questionstring
  • textstring
  • tierstring
  • personastring
  • as_ofstring
  • groundingobject
  • citationsarray of object
200Example response (illustrative)

Written by hand from the documented shape: AI readings are not captured automatically. Real text, token counts and credits differ.

Loading the example…

Request schema and every field: the AI interpretation reference.

Related endpoints

FAQ

AI Chat for a Couple API: common questions

4answers

Ask the team
01What does the AI Chat for a Couple API return?

An AI answer about two people, with earlier turns as history; grounded in their computed matching report. The response's data object includes mode, question, text, tier, persona, as_of, grounding and citations. See the reference for an example response.

02What input does AI Chat for a Couple need?

Two people's birth details.

03How much does a AI Chat for a Couple call cost?

Metered, from 15 credits per successful call; a failed call is not charged. Plans and top-ups are on the pricing page.

04Can I try it before paying?

Yes. Every account gets sandbox keys and trial credits, so you can call it from your own code before choosing a plan.