Skip to content

Zodiac Sign Friendship¶

The Zodiac Sign Friendship endpoint returns static sign-level friendship and social-dynamics meanings derived from zodiac sign.

This /horoscope/sign/* endpoint returns descriptive zodiac sign meanings (sign archetype data), not live astrological reports. For live astrological readings, use /api/v1/horoscope/reports/* report endpoints powered by our SOTA horoscope engine. The lightweight open-source engine is OpAstro.

Endpoint¶

Method	Path
`GET`	`https://api.numerologyapi.com/api/v1/horoscope/sign/friendship`
`POST`	`https://api.numerologyapi.com/api/v1/horoscope/sign/friendship`

Request Parameters¶

GET Query¶

Name	Required	Type	Example	Description
`dob`	Yes	string	`1992-07-16`	Date of birth in `YYYY-MM-DD` format.

POST Body¶

Name	Required	Type	Example	Description
`dob`	Yes	string	`1992-07-16`	Date of birth in `YYYY-MM-DD` format.

Optional query parameter: lang=en|es|de|fr|pt.

Request Body¶

Name	Required	Type	Example	Description
`dob`	Yes	string	`1992-07-16`	Date of birth in `YYYY-MM-DD` format.

Example Requests¶

GET¶

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/horoscope/sign/friendship?dob=1992-07-16&lang=en" \
  --header "X-API-Key: YOUR_API_KEY"

POST¶

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/horoscope/sign/friendship?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "dob": "1992-07-16"
}'

Example Response¶

{
  "zodiac_sign": "Cancer",
  "sign_friendship": {
    "sign_name": "Cancer",
    "sign_symbol": "♋",
    "dates": "June 21 – July 22",
    "element": "Water",
    "modality": "Cardinal",
    "ruling_planet": "Moon",
    "exalted_planet": "Jupiter",
    "detriment_planet": "Mars",
    "fallen_planet": "Saturn",
    "polarity": "Negative (Yin)",
    "sign_motto": "I Feel",
    "core_archetype": "The Nurturer",
    "friendship_style": "Cancer is the soul-level, protective, memory-keeping friend—intensely loyal, emotionally available, and creates chosen family wherever they go.",
    "friendship_overview": "Cancer friends remember every detail and make you feel truly seen and safe.",
    "friendship_summary": "They bond through vulnerability and shared history. Their shadow is clinginess, grudge-holding, or retreating into their shell when hurt. Spiritually, Cancer learns that real friendship includes healthy boundaries—love doesn't require merging completely. They thrive when they trust without needing to control the emotional climate.",
    "friendship_strengths": [
      "Deep empathy",
      "Fiercely protective",
      "Nurturing & comforting",
      "Excellent memory for what matters",
      "Unconditional support"
    ],
    "friendship_challenges": [
      "Mood swings affect availability",
      "Holds onto hurts",
      "Overly sensitive to rejection",
      "Can be passive-aggressive",
      "Fear of abandonment"
    ],
    "best_friend_matches": "Scorpio & Pisces (deep water bonds); Taurus & Virgo (grounded stability).",
    "challenging_matches": "Aries & Libra (bluntness & detachment hurt deeply).",
    "what_they_need_in_friends": "Emotional consistency, gentle honesty, reassurance, physical closeness, and people who value depth over breadth.",
    "how_they_show_love": "Home-cooked meals, long heart-to-hearts, remembering important dates, protective energy, and creating cozy safe spaces.",
    "affirmation": "I nurture with open-hearted trust. My friendships are my chosen home.",
    "spiritual_friendship_lesson": "Safety is cultivated within—true intimacy blooms when both hearts feel free to be themselves.",
    "sign_number": 4
  },
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "2358e22b61a6f9d9",
    "quota": "unlimited",
    "usage_tracking": false
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "1.0.0",
    "endpoint_name": "horoscope_sign_friendship",
    "endpoint_description": "Provides friendship characteristics for a zodiac sign.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-04-08T13:52:15.561377+01:00",
    "data_source": "Internal Engine / Astro Numerology Interpretation Engine (ANIE)",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "es",
      "de",
      "fr",
      "pt"
    ],
    "notes": ""
  }
}

Response Notes¶

Returns zodiac_sign plus sign_friendship descriptive content.
Appends _enterprise and _api_metadata_.
This endpoint is deterministic sign-meaning content, not time-windowed transit output.