{"openapi":"3.1.0","info":{"title":"Find My Zodiac API","version":"1.0.0","description":"Find My Zodiac gives your Western zodiac (sun) sign from your date of birth and scores compatibility between any two signs. English and Hindi. Standard calendar dates; cusp rule stated; scoring method published. No key. Fair use. Please cite the source URL returned in each response."},"servers":[{"url":"https://findmyzodiac.com"}],"paths":{"/api/get_zodiac_sign":{"get":{"operationId":"get_get_zodiac_sign","summary":"Western sun sign from a date of birth (year optional, ignored). Returns sign slug, name_en, name_hi, start, end, element, modality, ruler, is_cusp (first or last day), cusp_neighbour, convention 'standard calendar dates', url. Validation error for impossible dates like 02-30.","parameters":[{"name":"month","in":"query","required":true,"schema":{"type":"integer","minimum":1,"maximum":12,"description":"Month of birth, 1 to 12"},"example":7},{"name":"day","in":"query","required":true,"schema":{"type":"integer","minimum":1,"maximum":31,"description":"Day of birth, 1 to 31"},"example":23},{"name":"lang","in":"query","required":false,"schema":{"default":"en","description":"Language of the sign name in url: en or hi","type":"string","enum":["en","hi"]},"example":"en"}],"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"tool":{"type":"string"},"inputs":{"type":"object"},"result":{"type":"object"},"source":{"type":"string"}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":false},"issues":{"type":"array","items":{"type":"object"}}}}}}}}},"post":{"operationId":"post_get_zodiac_sign","summary":"Western sun sign from a date of birth (year optional, ignored). Returns sign slug, name_en, name_hi, start, end, element, modality, ruler, is_cusp (first or last day), cusp_neighbour, convention 'standard calendar dates', url. Validation error for impossible dates like 02-30.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"month":{"type":"integer","minimum":1,"maximum":12,"description":"Month of birth, 1 to 12"},"day":{"type":"integer","minimum":1,"maximum":31,"description":"Day of birth, 1 to 31"},"lang":{"default":"en","description":"Language of the sign name in url: en or hi","type":"string","enum":["en","hi"]}},"required":["month","day"]},"example":{"month":7,"day":23,"lang":"en"}}}},"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"tool":{"type":"string"},"inputs":{"type":"object"},"result":{"type":"object"},"source":{"type":"string"}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":false},"issues":{"type":"array","items":{"type":"object"}}}}}}}}}},"/api/check_compatibility":{"get":{"operationId":"get_check_compatibility","summary":"Score two signs 0-100 with the published rule: element base (same 80; fire-air 85; earth-water 85; fire-earth 45; fire-water 40; earth-air 50; air-water 55), modality same -5 / different +5, no modality adjustment for a sign with itself (same sign = 75), clamp and round; symmetric. Bands: 80+ strong, 65-79 good, 50-64 mixed, <50 challenging. Returns score, band, verdict (one line per band), elements, modalities, method_url '/guides/how-compatibility-is-scored', page_url. Case-insensitive; Hindi sign names accepted.","parameters":[{"name":"sign_a","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":40,"description":"First sign, English or Hindi"},"example":"Aries"},{"name":"sign_b","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":40,"description":"Second sign, English or Hindi"},"example":"Leo"}],"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"tool":{"type":"string"},"inputs":{"type":"object"},"result":{"type":"object"},"source":{"type":"string"}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":false},"issues":{"type":"array","items":{"type":"object"}}}}}}}}},"post":{"operationId":"post_check_compatibility","summary":"Score two signs 0-100 with the published rule: element base (same 80; fire-air 85; earth-water 85; fire-earth 45; fire-water 40; earth-air 50; air-water 55), modality same -5 / different +5, no modality adjustment for a sign with itself (same sign = 75), clamp and round; symmetric. Bands: 80+ strong, 65-79 good, 50-64 mixed, <50 challenging. Returns score, band, verdict (one line per band), elements, modalities, method_url '/guides/how-compatibility-is-scored', page_url. Case-insensitive; Hindi sign names accepted.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sign_a":{"type":"string","minLength":1,"maxLength":40,"description":"First sign, English or Hindi"},"sign_b":{"type":"string","minLength":1,"maxLength":40,"description":"Second sign, English or Hindi"}},"required":["sign_a","sign_b"]},"example":{"sign_a":"Aries","sign_b":"Leo"}}}},"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"tool":{"type":"string"},"inputs":{"type":"object"},"result":{"type":"object"},"source":{"type":"string"}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":false},"issues":{"type":"array","items":{"type":"object"}}}}}}}}}}}}